DSC voor Linux nxUser ResourceDSC for Linux nxUser Resource

De nxUser in PowerShell Desired State Configuration (DSC)-bron biedt een mechanisme op voor het beheren van lokale gebruikers op een Linux-knooppunt.The nxUser resource in PowerShell Desired State Configuration (DSC) provides a mechanism to to manage local users on a Linux node.

SyntaxisSyntax

nxUser <string> #ResourceName
{
    UserName = <string>
    [ Ensure = <string> { Absent | Present }  ]
    [ FullName = <string> ]
    [ Description = <string> ]
    [ Password = <string> ]
    [ Disabled = <bool> ]
    [ PasswordChangeRequired = <bool> ]
    [ HomeDirectory = <string> ]
    [ GroupID = <string> ]
    [ DependsOn = <string[]> ]

}

EigenschappenProperties

EigenschapProperty 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.
UserNameUserName Hiermee geeft u de locatie op waar u om te controleren of de status voor een bestand of map.Specifies the location where you want to ensure the state for a file or directory.
Zorg ervoor datEnsure Geeft aan of het account bestaat.Specifies whether 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 Een tekenreeks met de volledige naam moet worden gebruikt voor het gebruikersaccount.A string that contains the full name to use for the user account.
BeschrijvingDescription De beschrijving voor het gebruikersaccount.The description for the user account.
WachtwoordPassword De hash van het wachtwoord van gebruikers in de juiste vorm voor de Linux-computer.The hash of the users password in the appropriate form for the Linux computer. Dit is meestal een gezouten SHA-256 of SHA-512 hash.Typically, this is a salted SHA-256, or SHA-512 hash. Voor Debian en Ubuntu Linux, kan deze waarde met de opdracht mkpasswd worden gegenereerd.On Debian and Ubuntu Linux, this value can be generated with the mkpasswd command. Voor andere Linux-distributies, kan de methode crypt van Python Crypt bibliotheek worden gebruikt voor het genereren van de hash.For other Linux distros, the crypt method of Python’s Crypt library can be used to generate the hash.
DisabledDisabled Hiermee wordt aangegeven of het account is ingeschakeld.Indicates whether 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.
PasswordChangeRequiredPasswordChangeRequired Hiermee wordt aangegeven of de gebruiker het wachtwoord kunt wijzigen.Indicates whether the user can change the password. Deze eigenschap instellen op $true om ervoor te zorgen dat de gebruiker kan 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. Deze eigenschap wordt alleen beoordeeld als het gebruikersaccount niet aanwezig waren en wordt gemaakt.This property is only evaluated if the user account did not exist previously and is being created.
BasismapHomeDirectory De basismap voor de gebruiker.The home directory for the user.
Groeps-idGroupID De primaire groeps-ID voor de gebruiker.The primary group ID for the user.
dependsOnDependsOn Hiermee wordt aangegeven dat de configuratie van een andere resource uitvoeren moet voordat deze bron is geconfigureerd.Indicates that the configuration of another resource must run before this resource is configured. Bijvoorbeeld, als de ID van het scriptblok voor resource configuratie die u wilt uitvoeren eerst is 'ResourceName' en het type is '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

Het volgende voorbeeld zorgt ervoor dat de gebruiker "monuser" bestaat en lid van de groep 'DBusers is'.The following example ensures that the user "monuser" exists and is a member of the group "DBusers".

Import-DSCResource -Module nx

Node $node {
nxUser UserExample{
   UserName = "monuser"
   Description = "Monitoring user"
   Password  =    '$6$fZAne/Qc$MZejMrOxDK0ogv9SLiBP5J5qZFBvXLnDu8HY1Oy7ycX.Y3C7mGPUfeQy3A82ev3zIabhDQnj2ayeuGn02CqE/0'
   Ensure = "Present"
   HomeDirectory = "/home/monuser"
}

nxGroup GroupExample{
   GroupName = "DBusers"
   Ensure = "Present"
   MembersToInclude = "monuser"
   DependsOn = "[nxUser]UserExample"
}
}