DSC felhasználói erőforrás

A következőkre vonatkozik: Windows PowerShell 4.0, Windows PowerShell 5.x

A Windows PowerShell Desired State Configuration felhasználói erőforrása (DSC) egy mechanizmust biztosít a helyi felhasználói fiókok kezelésére a célcsomóponton.

Megjegyzés

A DSC-erőforrás dokumentációja a PowerShell 7.2-es verzió előtti verzióját tartalmazza. A PSDscResources modul a Microsoft által hivatalosan támogatott új és frissített DSC-erőforrásokat tartalmaz. A PSDscResources modul elérhető a PowerShell-galéria.

További információkért és a frissített dokumentációért tekintse meg a PSDscResources referenciadokumentációját.

Syntax

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ágok

Tulajdonság	Leírás
Felhasználónév	Azt a fióknevet jelzi, amelyhez egy adott állapotot szeretne biztosítani.
Leírás	A felhasználói fiókhoz használni kívánt leírást jelzi.
Disabled (Letiltva)	Azt jelzi, hogy a fiók engedélyezve van-e. Állítsa be ezt a tulajdonságot $true úgy, hogy a fiók le legyen tiltva, és állítsa be $false úgy, hogy az engedélyezve legyen.
FullName	A felhasználói fiókhoz használni kívánt teljes névvel rendelkező sztringet jelöli.
Jelszó	A fiókhoz használni kívánt jelszót jelzi.
PasswordChangeNotAllowed	Azt jelzi, hogy a felhasználó módosíthatja-e a jelszót. Állítsa be ezt a tulajdonságot $true úgy, hogy a felhasználó ne tudja módosítani a jelszót, és állítsa be úgy $false , hogy lehetővé tegye a felhasználó számára a jelszó módosítását. Az alapértelmezett érték $false.
PasswordChangeRequired	Azt jelzi, hogy a felhasználónak módosítania kell-e a jelszót a következő bejelentkezéskor. Állítsa ezt a tulajdonságot arra az esetre, $true ha a felhasználónak módosítania kell a jelszót. Az alapértelmezett érték $true.
PasswordNeverExpires	Azt jelzi, hogy a jelszó lejár-e. Annak érdekében, hogy a fiók jelszava soha ne járjon le, állítsa ezt a tulajdonságot a értékre $true. Állítsa be úgy, hogy $false a jelszó lejár-e. Az alapértelmezett érték $false.

Közös tulajdonságok

Tulajdonság	Leírás
DependsOn	Azt jelzi, hogy egy másik erőforrás konfigurációjának futnia kell az erőforrás konfigurálása előtt. Ha például az először futtatni kívánt erőforrás-konfigurációs szkriptblokk azonosítója ResourceName, és típusa ResourceType, akkor a tulajdonság használatának szintaxisa a DependsOn = "[ResourceType]ResourceName"következő: .
Biztosítja	Azt jelzi, hogy létezik-e a fiók. Állítsa ezt a tulajdonságot a Present (Jelen) értékre, és győződjön meg arról, hogy a fiók létezik, és állítsa a Hiányzó értékre, hogy a fiók ne létezzen. Az alapértelmezett érték a Jelen.
PsDscRunAsCredential	Beállítja a hitelesítő adatokat a teljes erőforrás futtatásához.

Megjegyzés

A PsDscRunAsCredential common tulajdonság hozzá lett adva a WMF 5.0-s verziójához, hogy bármely DSC-erőforrást más hitelesítő adatokkal összefüggésben futtathasson. További információ: Hitelesítő adatok használata DSC-erőforrásokkal.

Példa

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
}