Usuário

  • Artigo

Sinopse

Gerenciar um usuário local.

Sintaxe

User [String] #ResourceName
{
    UserName = [string]
    [DependsOn = [string[]]]
    [Description = [string]]
    [Disabled = [bool]]
    [Ensure = [string]{ Absent | Present }]
    [FullName = [string]]
    [Password = [PSCredential]]
    [PasswordChangeNotAllowed = [bool]]
    [PasswordChangeRequired = [bool]]
    [PasswordNeverExpires = [bool]]
    [PsDscRunAsCredential = [PSCredential]]
}

Descrição

O User recurso permite adicionar, atualizar e remover contas de usuário locais. Para gerenciar a associação de uma conta em grupos locais, consulte o recurso Grupo.

Requisitos

Nenhum

Propriedades

Propriedades da chave

UserName

Especifique o nome da conta como uma cadeia de caracteres.

Type: System.String

Propriedades opcionais

Descrição

Especifique uma discrição para a conta como uma cadeia de caracteres.

Type: System.String
Default Value: None

Desabilitado

Especifique se deseja desabilitar a conta. Defina essa propriedade para $true desabilitar a conta se ela estiver habilitada. Defina-a para $false habilitar a conta se ela estiver desabilitada.

O valor padrão é $false.

Type: System.Boolean
Default Value: false

Ensure

Especifique se o usuário deve existir. Defina essa propriedade para Present adicionar ou atualizar a conta. Defina essa propriedade para Absent remover a conta.

O valor padrão é Present.

Type: System.String
Behavior: Write
Accepted Values:
  - Absent
  - Present
Default Value: Present

FullName

Especifique o nome completo da conta como uma cadeia de caracteres.

Type: System.String
Default Value: None

Senha

Especifique uma credencial com a senha a ser usada para essa conta. O UserName do objeto de credencial não é usado, apenas a Senha.

Type: System.Management.Automation.PSCredential
Default Value: None

PasswordChangeNotAllowed

Especifique se o usuário pode alterar sua senha. Defina essa propriedade para $true impedir que o usuário altere sua senha. Defina essa propriedade para $false permitir que o usuário altere sua senha.

O valor padrão é $false.

Type: System.Boolean
Default Value: false

PasswordChangeRequired

Especifique se o usuário deve alterar sua senha. Defina essa propriedade para $true forçar o usuário a alterar sua senha na próxima vez que entrar. Defina essa propriedade para $false não exigir que o usuário altere sua senha.

O valor padrão é $true.

Type: System.Boolean
Default Value: true

PasswordNeverExpires

Especifique se a senha expira. Defina essa propriedade para $true impedir que a senha da conta expire. Defina essa propriedade para $false que a senha da conta expire por configurações de segurança do sistema.

O valor padrão é $false.

Type: System.Boolean
Default Value: false

Exemplos