Linux용 DSC nxGroup 리소스DSC for Linux nxGroup Resource

PowerShell DSC(필요한 상태 구성)의 nxGroup 리소스에서는 Linux 노드에 있는 로컬 그룹을 관리하는 메커니즘을 제공합니다.The nxGroup resource in PowerShell Desired State Configuration (DSC) provides a mechanism to manage local groups on a Linux node.

구문Syntax

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

속성Properties

속성Property 설명Description
GroupNameGroupName 특정 상태를 확인하려는 그룹의 이름을 지정합니다.Specifies the name of the group for which you want to ensure a specific state.
EnsureEnsure 해당 그룹이 존재하는지를 확인할지 여부를 결정합니다.Determines whether to check if the group exists. 해당 그룹이 존재하도록 하려면 이 속성을 "Present"으로 설정합니다.Set this property to "Present" to ensure the group exists. 해당 그룹이 존재하지 않도록 하려면 이 속성을 "Absent"으로 설정합니다.Set it to "Absent" to ensure the group does not exist. 기본값은 "Present"입니다.The default value is "Present".
구성원Members 그룹을 형성하는 구성원을 지정합니다.Specifies the members that form the group.
MembersToIncludeMembersToInclude 이 그룹의 구성원이 되도록 할 사용자를 지정합니다.Specifies the users who you want to ensure are members of the group.
MembersToExcludeMembersToExclude 이 그룹의 구성원이 되지 않도록 할 사용자를 지정합니다.Specifies the users who you want to ensure are not members of the group.
PreferredGroupIDPreferredGroupID 가능한 경우 그룹 ID를 제공된 값으로 설정합니다.Sets the group id to the provided value if possible. 현재 그룹 ID가 사용 중이라면 다음의 사용 가능한 그룹 ID가 사용됩니다.If the group id is currently in use, the next available group id is used.
DependsOnDependsOn 이 리소스를 구성하려면 먼저 다른 리소스의 구성을 실행해야 함을 나타냅니다.Indicates that the configuration of another resource must run before this resource is configured. 예를 들어, 먼저 실행하려는 리소스 구성 스크립트 블록의 IDResourceName이고 해당 형식이 ResourceType일 경우, 이 속성을 사용하기 위한 구문은 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'.

예제Example

다음 예제에서는 사용자 ‘monuser’가 존재하고 ‘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'
    }
}