Compartilhar via

Disable-LocalUser

Módulo:
Microsoft.PowerShell.LocalAccounts Module

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 é 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 de Convidado interna usando Get-LocalUsere, em seguida, passa-a para o cmdlet atual usando o operador de pipeline(|). Esse cmdlet desabilita essa conta.

Parâmetros

-Confirm

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 do parâmetro

Tipo:

Microsoft.PowerShell.Commands.LocalUser[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

InputObject
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Name

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

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Default
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-SID

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

Propriedades do parâmetro

Tipo:

SecurityIdentifier[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SecurityIdentifier
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 encaminhar uma cadeia de caracteres para este cmdlet.

SecurityIdentifier

Você pode canalizar um SID para este 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, LocalGroupe 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 pelo Windows 10, Windows Server 2016 e versões posteriores do sistema operacional Windows. Em versões anteriores, a propriedade está em branco.