Udostępnij za pośrednictwem

Disable-LocalUser

  • Odwołanie
Moduł:
Microsoft.PowerShell.LocalAccounts

Wyłącza konto użytkownika lokalnego.

Składnia

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

Opis

Polecenie Disable-LocalUser cmdlet wyłącza konta użytkowników lokalnych. 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

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 polecenia 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

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InputObject

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

Typ:Microsoft.PowerShell.Commands.LocalUser[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

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

Typ:String[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-SID

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

Typ:SecurityIdentifier[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

System.Management.Automation.SecurityAccountsManager.LocalUser

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

String

Możesz przekazać 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 programu Disable-LocalUser:

  • dlu

Właściwość PrincipalSource jest właściwością localuser, LocalGroup i LocalPrincipal obiektów opisujących źródło obiektu. Możliwe źródła są następujące:

  • Lokalny
  • Active Directory
  • Grupa Microsoft Entra
  • Microsoft Account

JednostkaSource 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.