Recurso nxGroup de DSC para LinuxDSC for Linux nxGroup Resource

El recurso nxGroup de la configuración de estado deseado (DSC) de PowerShell ofrece un mecanismo para administrar grupos locales en un nodo de Linux.The nxGroup resource in PowerShell Desired State Configuration (DSC) provides a mechanism to manage local groups on a Linux node.

SintaxisSyntax

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

PropiedadesProperties

PropiedadProperty DescripciónDescription
NombreDeGrupoGroupName Especifica el nombre del grupo para el que quiere garantizar un estado específico.Specifies the name of the group for which you want to ensure a specific state.
MembersMembers Especifica a los miembros que forman el grupo.Specifies the members that form the group.
MembersToIncludeMembersToInclude Especifica los usuarios que quiera garantizar que sean miembros del grupo.Specifies the users who you want to ensure are members of the group.
MembersToExcludeMembersToExclude Especifica los usuarios que quiera garantizar que no sean miembros del grupo.Specifies the users who you want to ensure are not members of the group.
PreferredGroupIDPreferredGroupID Establece el identificador de grupo en el valor proporcionado, si es posible.Sets the group id to the provided value if possible. Si el identificador de grupo está actualmente en uso, se utiliza el siguiente identificador de grupo disponible.If the group id is currently in use, the next available group id is used.

Propiedades comunesCommon properties

PropiedadProperty DescripciónDescription
DependsOnDependsOn Indica que la configuración de otro recurso debe ejecutarse antes de que se configure este recurso.Indicates that the configuration of another resource must run before this resource is configured. Por ejemplo, si el elemento ID del bloque del script de configuración del recurso que quiere ejecutar primero es ResourceName y su tipo es ResourceType, la sintaxis para usar esta propiedad es 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".
EnsureEnsure Determina si se debe comprobar si existe el grupo.Determines whether to check if the group exists. Establezca esta propiedad en Present para asegurarse de que el grupo exista.Set this property to Present to ensure the group exists. Establézcala en Absent para asegurarse de que el grupo no exista.Set it to Absent to ensure the group does not exist. El valor predeterminado es Present .The default value is Present .

EjemploExample

El ejemplo siguiente se asegura de que el usuario "monuser" exista y de que sea un miembro del grupo "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'
    }
}