Risorsa User DSC

Si applica a: 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.

Nota

Questa documentazione di questa risorsa DSC illustra la versione inclusa in PowerShell prima della versione 7.2. Il modulo PSDscResources contiene risorse DSC nuove e aggiornate supportate ufficialmente da Microsoft. Il modulo PSDscResources è disponibile da PowerShell Gallery.

Per altre informazioni e la documentazione aggiornata, vedere la documentazione di riferimento di PSDscResources.

Sintassi

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à

Proprietà	Descrizione
UserName	Indica il nome dell'account per cui si vuole specificare un determinato stato.
Descrizione	Indica la descrizione che si vuole usare per l'account utente.
Disabled	Indica se l'account è abilitato. Impostare questa proprietà su $true per assicurarsi che l'account sia disabilitato e su $false per assicurarsi che sia abilitato.
FullName	Rappresenta una stringa che contiene il nome completo da usare per l'account utente.
Password	Indica la password da usare per l'account.
PasswordChangeNotAllowed	Indica se l'utente può modificare la 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. Il valore predefinito è $false.
PasswordChangeRequired	Indica se l'utente dovrà cambiare la password all'accesso successivo. Impostare questa proprietà su $true se l'utente deve cambiare la password. Il valore predefinito è $true.
PasswordNeverExpires	Indica se la password scadrà. Per assicurarsi che la password per questo account non scada mai, impostare questa proprietà su $true. Impostarla su $false se la password scadrà. Il valore predefinito è $false.

Proprietà comuni

Proprietà	Descrizione
DependsOn	Indica che prima di configurare la risorsa è necessario eseguire la configurazione di un'altra risorsa. 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".
Ensure	Indica se l'account esiste. Impostare questa proprietà su Present per assicurarsi che l'account esista e impostarlo su Absent per assicurarsi che l'account non esista. Il valore predefinito è Present.
PsDscRunAsCredential	Imposta le credenziali per l'esecuzione dell'intera risorsa.

Nota

La proprietà comune PsDscRunAsCredential è stata aggiunta in WMF 5.0 per consentire l'esecuzione di qualsiasi risorsa DSC nel contesto di altre credenziali. Per altre informazioni, vedere Usare credenziali con risorse DSC.

Esempio

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
}