Recurso do usuário de DSC#DSC User Resource#

Aplica-se a: Windows PowerShell 4.0, Windows PowerShell 5.0Applies To: Windows PowerShell 4.0, Windows PowerShell 5.0

O recurso User na Configuração de Estado Desejado (DSC) do Windows PowerShell fornece um mecanismo para contas de usuário locais no nó de destino.The User resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to manage local user accounts on the target node.

Sintaxe##Syntax##

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

PropriedadesProperties

PropriedadeProperty DescriçãoDescription
UserNameUserName Indica o nome da conta para a qual você deseja garantir um estado específico.Indicates the account name for which you want to ensure a specific state.
DescriçãoDescription Indica a descrição que você deseja usar para a conta de usuário.Indicates the description you want to use for the user account.
DesabilitadoDisabled Indica se a conta está habilitada.Indicates if the account is enabled. Defina essa propriedade como $true para garantir que essa conta esteja desabilitada e defina-a como $false para garantir que esteja habilitada.Set this property to $true to ensure that this account is disabled, and set it to $false to ensure that it is enabled.
EnsureEnsure Indica se a conta existe.Indicates if the account exists. Defina essa propriedade como "Present" para garantir que a conta exista e defina-o como "Absent" para garantir que a conta não exista.Set this property to "Present" to ensure that the account exists, and set it to "Absent" to ensure that the account does not exist.
FullNameFullName Representa uma cadeia de caracteres com o nome completo que você deseja usar para a conta de usuário.Represents a string with the full name you want to use for the user account.
SenhaPassword Indica a senha que você deseja usar para essa conta.Indicates the password you want to use for this account.
PasswordChangeNotAllowedPasswordChangeNotAllowed Indica se o usuário pode alterar a senha.Indicates if the user can change the password. Defina essa propriedade como $true para garantir que o usuário não possa alterar a senha e defina-a como $false para permitir que o usuário altere a senha.Set this property to $true to ensure that the user cannot change the password, and set it to $false to allow the user to change the password. O valor padrão é $false.The default value is $false.
PasswordChangeRequiredPasswordChangeRequired Indica se o usuário deve alterar a senha na próxima entrada.Indicates if the user must change the password at the next sign in. Defina essa propriedade como $true se o usuário precisar alterar a senha.Set this property to $true if the user must change the password. O valor padrão é $true.The default value is $true.
PasswordNeverExpiresPasswordNeverExpires Indica se a senha vai expirar.Indicates if the password will expire. Para garantir que a senha para essa conta nunca expire, defina essa propriedade como $true; defina-a como $false caso a senha vá expirar.To ensure that the password for this account will never expire, set this property to $true, and set it to $false if the password will expire. O valor padrão é $false.The default value is $false.
DependsOnDependsOn Indica que a configuração de outro recurso deve ser executada antes de ele ser configurado.Indicates that the configuration of another resource must run before this resource is configured. Por exemplo, se a ID do bloco de script de configuração do recurso que você deseja executar primeiro for ResourceName e seu tipo for ResourceType, a sintaxe para usar essa propriedade será DependsOn = "[ResourceType]ResourceName".For example, if the ID of the resource configuration script block that you want to run first is ResourceName and its type is ResourceType, the syntax for using this property is DependsOn = "[ResourceType]ResourceName".

ExemploExample

User UserExample
{
    Ensure = "Present"  # To ensure the user account does not exist, set Ensure to "Absent"
    UserName = "SomeName"
    Password = $passwordCred # This needs to be a credential object
    DependsOn = "[Group]GroupExample" # Configures GroupExample first
}