Disable-LocalUser
Desabilita uma conta de usuário local.
Sintaxe
InputObject
Disable-LocalUser
[-InputObject] <LocalUser[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Default
Disable-LocalUser
[-Name] <String[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
SecurityIdentifier
Disable-LocalUser
[-SID] <SecurityIdentifier[]>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Disable-LocalUser desabilita contas de usuário locais. Quando uma conta de usuário é desabilitada, o usuário não pode fazer logon. Quando uma conta de usuário está habilitada, o usuário pode fazer logon.
Observação
O módulo Microsoft.PowerShell.LocalAccounts não está disponível no PowerShell de 32 bits em um sistema de 64 bits.
Exemplos
Exemplo 1: Desativar uma conta especificando um nome
Disable-LocalUser -Name "Admin02"
Este comando desativa a conta de usuário chamada Admin02.
Exemplo 2: Desabilitar uma conta usando o pipeline
Get-LocalUser Guest | Disable-LocalUser
Este comando obtém a conta de convidado interna usando Get-LocalUsere, em seguida, a passa para o cmdlet atual usando o operador de pipeline(|). Esse cmdlet desabilita essa conta.
Parâmetros
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-InputObject
Especifica uma matriz de contas de usuário que esse cmdlet desabilita. Para obter uma conta de usuário, use o cmdlet Get-LocalUser.
Propriedades dos parâmetros
| Tipo: | Microsoft.PowerShell.Commands.LocalUser[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
InputObject
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-Name
Especifica uma matriz de nomes das contas de usuário que esse cmdlet desabilita.
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
Default
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-SID
Especifica uma matriz de contas de usuário que esse cmdlet desabilita.
Propriedades dos parâmetros
| Tipo: | |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
SecurityIdentifier
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | True |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
System.Management.Automation.SecurityAccountsManager.LocalUser
Você pode canalizar este cmdlet para um usuário local.
String
Você pode canalizar uma cadeia de caracteres para este cmdlet.
SecurityIdentifier
Você pode canalizar um SID para este cmdlet.
Saídas
None
Este cmdlet não retorna nenhuma saída.
Notas
O Windows PowerShell inclui os seguintes aliases para Disable-LocalUser:
dlu
A propriedade PrincipalSource é uma propriedade nos objetos LocalUser, LocalGroupe LocalPrincipal que descreve a origem do objeto. As fontes possíveis são as seguintes:
- Locais
- Active Directory
- Grupo Microsoft Entra
- Conta Microsoft
PrincipalSource é suportado apenas pelo Windows 10, Windows Server 2016 e versões posteriores do sistema operacional Windows. Para versões anteriores, a propriedade está em branco.