Udostępnij przez


Disable-LocalUser

Wyłącza konto użytkownika lokalnego.

Składnia

InputObject

Disable-LocalUser
    [-InputObject] <LocalUser[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Default

Disable-LocalUser
    [-Name] <String[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SecurityIdentifier

Disable-LocalUser
    [-SID] <SecurityIdentifier[]>
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Opis

Polecenie cmdlet Disable-LocalUser wyłącza lokalne konta użytkowników. Gdy konto użytkownika jest wyłączone, użytkownik nie może się zalogować. Po włączeniu konta użytkownika użytkownik może się zalogować.

Uwaga / Notatka

Moduł Microsoft.PowerShell.LocalAccounts nie jest dostępny w 32-bitowym programie PowerShell w systemie 64-bitowym.

Przykłady

Przykład 1: Wyłączanie konta przez określenie nazwy

Disable-LocalUser -Name "Admin02"

To polecenie wyłącza konto użytkownika o nazwie Admin02.

Przykład 2. Wyłączanie konta przy użyciu potoku

Get-LocalUser Guest | Disable-LocalUser

To polecenie pobiera wbudowane konto gościa przy użyciu Get-LocalUser, a następnie przekazuje je do bieżącego polecenia cmdlet przy użyciu operatora potoku(|). To polecenie cmdlet wyłącza to konto.

Parametry

-Confirm

Prosi o potwierdzenie przed uruchomieniem cmdletu.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:por

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-InputObject

Określa tablicę kont użytkowników, które to polecenie cmdlet wyłącza. Aby uzyskać konto użytkownika, użyj polecenia cmdlet Get-LocalUser.

Właściwości parametru

Typ:

Microsoft.PowerShell.Commands.LocalUser[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

InputObject
Position:0
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-Name

Określa tablicę nazw kont użytkowników, które to polecenie cmdlet wyłącza.

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

Default
Position:0
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-SID

Określa tablicę kont użytkowników, które to polecenie cmdlet wyłącza.

Właściwości parametru

Typ:

SecurityIdentifier[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

SecurityIdentifier
Position:0
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-WhatIf

Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie jest uruchomiony.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Wi

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

System.Management.Automation.SecurityAccountsManager.LocalUser

Możesz przekazać użytkownikowi lokalnego to polecenie cmdlet.

String

Możesz przesłać ciąg do tego polecenia cmdlet.

SecurityIdentifier

Do tego polecenia cmdlet można przekazać identyfikator SID.

Dane wyjściowe

None

To polecenie cmdlet nie zwraca żadnych danych wyjściowych.

Uwagi

Program Windows PowerShell zawiera następujące aliasy dla Disable-LocalUser:

  • dlu

Właściwość PrincipalSource jest właściwością obiektów LocalUser, LocalGroupi LocalPrincipal, która opisuje źródło obiektu. Możliwe źródła są następujące:

  • Lokalny
  • Active Directory
  • Grupa Microsoft Entra
  • Konto Microsoft

PrincipalSource jest obsługiwana tylko przez system Windows 10, Windows Server 2016 i nowsze wersje systemu operacyjnego Windows. W przypadku wcześniejszych wersji właściwość jest pusta.