Gebruiker van de DSC-ResourceDSC User Resource

Van toepassing op: Windows PowerShell 4.0, Windows PowerShell 5.0Applies To: Windows PowerShell 4.0, Windows PowerShell 5.0

De gebruiker resource in Windows PowerShell Desired State Configuration (DSC) biedt een mechanisme voor het beheren van lokale gebruikersaccounts op het doelknooppunt.The User resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to manage local user accounts on the target node.

SyntaxisSyntax

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[]] ]
}

EigenschappenProperties

EigenschapProperty BeschrijvingDescription
UserNameUserName Geeft de accountnaam waarvan u wilt om te controleren of een specifieke status.Indicates the account name for which you want to ensure a specific state.
BeschrijvingDescription Geeft aan dat de beschrijving die u wilt gebruiken voor het gebruikersaccount.Indicates the description you want to use for the user account.
DisabledDisabled Geeft aan of het account is ingeschakeld.Indicates if the account is enabled. Deze eigenschap instellen op $true om ervoor te zorgen dat dit account is uitgeschakeld, en stel deze in op $false om ervoor te zorgen dat deze is ingeschakeld.Set this property to $true to ensure that this account is disabled, and set it to $false to ensure that it is enabled.
Zorg ervoor datEnsure Geeft aan of het account bestaat.Indicates if the account exists. Deze eigenschap instellen op 'Aanwezig' om ervoor te zorgen dat het account bestaat en stel deze in op 'Ontbreekt' om ervoor te zorgen dat het account niet bestaat.Set this property to "Present" to ensure that the account exists, and set it to "Absent" to ensure that the account does not exist.
Volledige naamFullName Hiermee geeft u een tekenreeks zijn met de volledige naam die u wilt gebruiken voor het gebruikersaccount.Represents a string with the full name you want to use for the user account.
WachtwoordPassword Geeft het wachtwoord die u wilt gebruiken voor dit account.Indicates the password you want to use for this account.
PasswordChangeNotAllowedPasswordChangeNotAllowed Hiermee wordt aangegeven als de gebruiker het wachtwoord kunt wijzigen.Indicates if the user can change the password. Deze eigenschap instellen op $true om ervoor te zorgen dat de gebruiker kan niet het wachtwoord wijzigen en stel deze in op $false zodat de gebruiker het wachtwoord te wijzigen.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. De standaardwaarde is $false.The default value is $false.
PasswordChangeRequiredPasswordChangeRequired Hiermee wordt aangegeven als de gebruiker het wachtwoord bij de volgende aanmelding moet wijzigen.Indicates if the user must change the password at the next sign in. Deze eigenschap instellen op $true als de gebruiker het wachtwoord moet wijzigen.Set this property to $true if the user must change the password. De standaardwaarde is $true.The default value is $true.
PasswordNeverExpiresPasswordNeverExpires Hiermee wordt aangegeven als het wachtwoord verloopt.Indicates if the password will expire. Om ervoor te zorgen dat het wachtwoord voor dit account nooit verloopt, deze eigenschap instellen op $true, en stel deze in op $false als het wachtwoord verloopt.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. De standaardwaarde is $false.The default value is $false.
DependsOnDependsOn Geeft aan dat de configuratie van een andere resource uitvoeren moet voordat deze resource is geconfigureerd.Indicates that the configuration of another resource must run before this resource is configured. Bijvoorbeeld, als de ID van de resourceconfiguratie scriptblok die u wilt uitvoeren eerst is ResourceName en het type ResourceType, de syntaxis voor het gebruik van deze eigenschap is 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".

VoorbeeldExample

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
}