DSC felhasználói erőforrásDSC User Resource

A következőkre vonatkozik: Windows PowerShell 4,0, Windows PowerShell 5. xApplies To: Windows PowerShell 4.0, Windows PowerShell 5.x

A Windows PowerShell desired State Configuration (DSC) felhasználói erőforrása egy olyan mechanizmust biztosít a helyi felhasználói fiókok kezeléséhez a cél csomóponton.The User resource in Windows PowerShell Desired State Configuration (DSC) provides a mechanism to manage local user accounts on the target node.

SyntaxSyntax

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

TulajdonságokProperties

TulajdonságProperty LeírásDescription
FelhasználónévUserName Annak a fióknak a nevét jelzi, amelynek az adott állapotát biztosítani kívánja.Indicates the account name for which you want to ensure a specific state.
LeírásDescription Megadja a felhasználói fiókhoz használni kívánt leírást.Indicates the description you want to use for the user account.
Disabled (Letiltva)Disabled Azt jelzi, hogy a fiók engedélyezve van-e.Indicates if the account is enabled. Ezt a tulajdonságot úgy állítsa be, hogy a $true fiók le legyen tiltva, és állítsa be, hogy az $false engedélyezve legyen.Set this property to $true to ensure that this account is disabled, and set it to $false to ensure that it is enabled.
FullNameFullName A felhasználói fiókhoz használni kívánt teljes névvel rendelkező karakterláncot jelöli.Represents a string with the full name you want to use for the user account.
JelszóPassword Megadja a fiókhoz használni kívánt jelszót.Indicates the password you want to use for this account.
PasswordChangeNotAllowedPasswordChangeNotAllowed Azt jelzi, hogy a felhasználó módosíthatja-e a jelszót.Indicates if the user can change the password. Ennek a tulajdonságnak a beállításával $true biztosíthatja, hogy a felhasználó ne módosítsa a jelszót, és állítsa be úgy, hogy $false engedélyezze a felhasználó számára a jelszó módosítását.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. Az alapértelmezett érték $false.The default value is $false.
PasswordChangeRequiredPasswordChangeRequired Azt jelzi, hogy a felhasználónak meg kell-e változtatnia a jelszót a következő bejelentkezéskor.Indicates if the user must change the password at the next sign in. Állítsa be ezt a tulajdonságot, $true Ha a felhasználónak meg kell változtatnia a jelszót.Set this property to $true if the user must change the password. Az alapértelmezett érték $true.The default value is $true.
PasswordNeverExpiresPasswordNeverExpires Azt jelzi, hogy a jelszó lejár-e.Indicates if the password will expire. Annak biztosítása érdekében, hogy a fiók jelszava soha ne járjon le, állítsa ezt a tulajdonságot a következőre: $true .To ensure that the password for this account will never expire, set this property to $true. Állítsa be a $false jelszót, ha a jelszó lejár.Set it to $false if the password will expire. Az alapértelmezett érték $false.The default value is $false.

Közös tulajdonságokCommon properties

TulajdonságProperty LeírásDescription
DependsOnDependsOn Azt jelzi, hogy egy másik erőforrás konfigurációjának futnia kell az erőforrás konfigurálása előtt.Indicates that the configuration of another resource must run before this resource is configured. Ha például az az erőforrás-konfigurációs parancsfájl blokkja, amelyet először szeretne futtatni, ResourceName, és a típusa ResourceType, a tulajdonság használatának szintaxisa a következő: 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".
BiztosításaEnsure Azt jelzi, hogy létezik-e a fiók.Indicates if the account exists. Állítsa be ezt a tulajdonságot úgy, hogy a fiók létezik, és állítsa a hiányzó értékre, és győződjön meg arról, hogy a fiók nem létezik.Set this property to Present to ensure that the account exists, and set it to Absent to ensure that the account does not exist. Az alapértelmezett érték jelen van.The default value is Present .
PsDscRunAsCredentialPsDscRunAsCredential Beállítja a teljes erőforrás futtatásához használt hitelesítő adatokat.Sets the credential for running the entire resource as.

Megjegyzés

A PsDscRunAsCredential Common tulajdonsága a WMF 5,0-ben lett hozzáadva, hogy bármely DSC-erőforrást más hitelesítő adatok kontextusában futtasson.The PsDscRunAsCredential common property was added in WMF 5.0 to allow running any DSC resource in the context of other credentials. További információ: a hitelesítő adatok használata a DSC-erőforrásokkal.For more information, see Use Credentials with DSC Resources.

PéldaExample

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
}