Compartilhar via

Disable-LocalUser

  • Referência
Módulo:
Microsoft.PowerShell.LocalAccounts

Desabilita uma conta de usuário local.

Sintaxe

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

Description

O Disable-LocalUser cmdlet desabilita contas de usuário locais. Quando uma conta de usuário é desativada, 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: Desabilitar uma conta especificando um nome

Disable-LocalUser -Name "Admin02"

Esse comando desabilita a conta de usuário chamada Admin02.

Exemplo 2: Desabilitar uma conta usando o pipeline

Get-LocalUser Guest | Disable-LocalUser

Esse comando obtém a conta Guest interna usando Get-LocalUsere a passa para o cmdlet atual usando o pipeline operator(|). Esse cmdlet desabilita essa conta.

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifica uma matriz de contas de usuário que esse cmdlet desabilita. Para obter uma conta de usuário, use o Get-LocalUser cmdlet.

Tipo:Microsoft.PowerShell.Commands.LocalUser[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifica uma matriz de nomes das contas de usuário que esse cmdlet desabilita.

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SID

Especifica uma matriz de contas de usuário que esse cmdlet desabilita.

Tipo:SecurityIdentifier[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

System.Management.Automation.SecurityAccountsManager.LocalUser

Você pode canalizar um usuário local com esse cmdlet.

String

Você pode canalizar uma cadeia de caracteres para esse cmdlet.

SecurityIdentifier

Você pode canalizar um SID para esse cmdlet.

Saídas

None

Esse cmdlet não retorna nenhuma saída.

Observações

O Windows PowerShell inclui os seguintes aliases para Disable-LocalUser:

  • dlu

A propriedade PrincipalSource é uma propriedade nos objetos LocalUser, LocalGroup e LocalPrincipal que descreve a origem do objeto. As fontes possíveis são as seguintes:

  • Local
  • Active Directory
  • Grupo do Microsoft Entra
  • Conta da Microsoft

PrincipalSource tem suporte apenas para Windows 10, Windows Server 2016 e versões posteriores do sistema operacional Windows. Para versões anteriores, a propriedade está em branco.