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