Recurso nxGroup de DSC para LinuxDSC for Linux nxGroup Resource

O recurso nxGroup na Configuração de Estado Desejado (DSC) do PowerShell fornece um mecanismo para gerenciar grupos locais em um nó do Linux.The nxGroup resource in PowerShell Desired State Configuration (DSC) provides a mechanism to manage local groups on a Linux node.

SintaxeSyntax

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

PropriedadesProperties

PropriedadeProperty DescriçãoDescription
GroupNameGroupName Especifica o nome do grupo para o qual você deseja garantir um estado específico.Specifies the name of the group for which you want to ensure a specific state.
EnsureEnsure Determina se é necessário verificar se o grupo existe.Determines whether to check if the group exists. Defina essa propriedade como "Present" para garantir que o grupo exista.Set this property to "Present" to ensure the group exists. Defina-a como "Absent" para garantir que o grupo não exista.Set it to "Absent" to ensure the group does not exist. O valor padrão é "Present".The default value is "Present".
MembrosMembers Especifica os membros que formam o grupo.Specifies the members that form the group.
MembersToIncludeMembersToInclude Especifica os usuários que você deseja garantir que sejam membros do grupo.Specifies the users who you want to ensure are members of the group.
MembersToExcludeMembersToExclude Especifica os usuários que você deseja garantir que não sejam membros do grupo.Specifies the users who you want to ensure are not members of the group.
PreferredGroupIDPreferredGroupID Define a ID do grupo para o valor fornecido, se possível.Sets the group id to the provided value if possible. Se a ID do grupo estiver em uso no momento, a próxima ID de grupo disponível será usada.If the group id is currently in use, the next available group id is used.
DependsOnDependsOn Indica que a configuração de outro recurso deve ser executada antes de ele ser configurado.Indicates that the configuration of another resource must run before this resource is configured. Por exemplo, se a ID do bloco de script de configuração do recurso que você deseja executar primeiro for ResourceName e seu tipo for ResourceType, a sintaxe para usar essa propriedade será 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".

ExemploExample

O exemplo a seguir garante que o usuário “monuser” exista e seja membro do 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"            
}
}