Risorsa User DSCDSC User Resource

Si applica a: Windows PowerShell 4.0, Windows PowerShell 5.xApplies To: Windows PowerShell 4.0, Windows PowerShell 5.x

La risorsa User in Windows PowerShell DSC (Desired State Configuration) fornisce un meccanismo per gestire gli account utente locali nel nodo di destinazione.The User resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to manage local user accounts on the target node.

Nota

La documentazione di questa risorsa DSC riguarda la versione inclusa in PowerShell.This documentation of this DSC resource covers the version that is included with PowerShell. Il modulo PSDscResources contiene elementi nuovi e aggiornati ufficialmente supportati da Microsoft.The PSDscResources module contains new and updated that are officially supported by Microsoft. Il modulo PSDscResources è disponibile da PowerShell Gallery.The PSDscResources module is available from the PowerShell Gallery.

Per altre informazioni e per la documentazione aggiornata, vedere il file LEGGIMI nel repository GitHub.For more information and updated documentation, see the README in the GitHub repository.

SintassiSyntax

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

ProprietàProperties

ProprietàProperty DescrizioneDescription
UserNameUserName Indica il nome dell'account per cui si vuole specificare un determinato stato.Indicates the account name for which you want to ensure a specific state.
DescrizioneDescription Indica la descrizione che si vuole usare per l'account utente.Indicates the description you want to use for the user account.
DisabledDisabled Indica se l'account è abilitato.Indicates if the account is enabled. Impostare questa proprietà su $true per assicurarsi che l'account sia disabilitato e su $false per assicurarsi che sia abilitato.Set this property to $true to ensure that this account is disabled, and set it to $false to ensure that it is enabled.
FullNameFullName Rappresenta una stringa che contiene il nome completo da usare per l'account utente.Represents a string with the full name you want to use for the user account.
PasswordPassword Indica la password da usare per l'account.Indicates the password you want to use for this account.
PasswordChangeNotAllowedPasswordChangeNotAllowed Indica se l'utente può modificare la password.Indicates if the user can change the password. Impostare questa proprietà su $true per assicurarsi che l'utente non possa modificare la password e su $false per consentire all'utente di modificare la password.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. Il valore predefinito è $false.The default value is $false.
PasswordChangeRequiredPasswordChangeRequired Indica se l'utente dovrà cambiare la password all'accesso successivo.Indicates if the user must change the password at the next sign in. Impostare questa proprietà su $true se l'utente deve cambiare la password.Set this property to $true if the user must change the password. Il valore predefinito è $true.The default value is $true.
PasswordNeverExpiresPasswordNeverExpires Indica se la password scadrà.Indicates if the password will expire. Per assicurarsi che la password per questo account non scada mai, impostare questa proprietà su $true.To ensure that the password for this account will never expire, set this property to $true. Impostarla su $false se la password scadrà.Set it to $false if the password will expire. Il valore predefinito è $false.The default value is $false.

Proprietà comuniCommon properties

ProprietàProperty DescrizioneDescription
DependsOnDependsOn Indica che prima di configurare la risorsa è necessario eseguire la configurazione di un'altra risorsa.Indicates that the configuration of another resource must run before this resource is configured. Ad esempio, se il valore di ID del blocco script di configurazione della risorsa che si vuole eseguire per primo è ResourceName e il tipo è ResourceType, la sintassi per usare questa proprietà è 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".
EnsureEnsure Indica se l'account esiste.Indicates if the account exists. Impostare questa proprietà su Present per assicurarsi che l'account esista e su Absent per specificare che non esiste.Set this property to Present to ensure that the account exists, and set it to Absent to ensure that the account does not exist. Il valore predefinito è Present .The default value is Present .
PsDscRunAsCredentialPsDscRunAsCredential Imposta le credenziali per l'esecuzione dell'intera risorsa.Sets the credential for running the entire resource as.

Nota

La proprietà comune PsDscRunAsCredential è stata aggiunta in WMF 5.0 per consentire l'esecuzione di qualsiasi risorsa DSC nel contesto di altre credenziali.The PsDscRunAsCredential common property was added in WMF 5.0 to allow running any DSC resource in the context of other credentials. Per altre informazioni, vedere Usare credenziali con risorse DSC.For more information, see Use Credentials with DSC Resources.

EsempioExample

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
}