Zasób DSC dla zasób nxgroup systemu LinuxDSC for Linux nxGroup Resource

Zasób zasób nxgroup w konfiguracji żądanego stanu (DSC) programu PowerShell zapewnia mechanizm zarządzania grupami lokalnymi w węźle z systemem Linux.The nxGroup resource in PowerShell Desired State Configuration (DSC) provides a mechanism to manage local groups on a Linux node.

SkładniaSyntax

nxGroup <string> #ResourceName
{
    GroupName = <string>
    [ Members = <string[]> ]
    [ MembersToInclude = <string[]> ]
    [ MembersToExclude = <string[]> ]
    [ PreferredGroupID = <string> ]
    [ DependsOn = <string[]> ]
    [ Ensure = <string> { Absent | Present } ]
}

WłaściwościProperties

WłaściwośćProperty OpisDescription
GroupNameGroupName Określa nazwę grupy, dla której chcesz zapewnić określony stan.Specifies the name of the group for which you want to ensure a specific state.
Elementy członkowskieMembers Określa członków, którzy tworzą grupę.Specifies the members that form the group.
MembersToIncludeMembersToInclude Określa użytkowników, którzy chcą mieć pewność, że są członkami grupy.Specifies the users who you want to ensure are members of the group.
MembersToExcludeMembersToExclude Określa użytkowników, którzy chcą mieć pewność, że nie są członkami grupy.Specifies the users who you want to ensure are not members of the group.
PreferredGroupIDPreferredGroupID W razie potrzeby ustawia identyfikator grupy na podaną wartość.Sets the group id to the provided value if possible. Jeśli identyfikator grupy jest aktualnie używany, zostanie użyty następny dostępny identyfikator grupy.If the group id is currently in use, the next available group id is used.

Wspólne właściwościCommon properties

WłaściwośćProperty OpisDescription
DependsOnDependsOn Wskazuje, że konfiguracja innego zasobu musi być uruchomiona przed skonfigurowaniem tego zasobu.Indicates that the configuration of another resource must run before this resource is configured. Na przykład, jeśli identyfikator bloku skryptu konfiguracji zasobu, który ma zostać uruchomiony jako pierwszy jest resourceName, a jego typ to ResourceType, Składnia służąca do użycia tej właściwości to 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".
Upewnij się żeEnsure Określa, czy należy sprawdzić, czy grupa istnieje.Determines whether to check if the group exists. Ustaw tę właściwość na obecną , aby upewnić się, że grupa istnieje.Set this property to Present to ensure the group exists. Ustaw na Brak , aby upewnić się, że grupa nie istnieje.Set it to Absent to ensure the group does not exist. Wartość domyślna jest obecna .The default value is Present .

PrzykładExample

W poniższym przykładzie zagwarantujemy, że użytkownik "monuser" istnieje i jest członkiem grupy "dbusers".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'
    }
}