그룹

아티클
05/05/2023

개요

로컬 그룹을 관리합니다.

구문

Group [String] #ResourceName
{
    GroupName = [string]
    [Credential = [PSCredential]]
    [DependsOn = [string[]]]
    [Description = [string]]
    [Ensure = [string]{ Absent | Present }]
    [Members = [string[]]]
    [MembersToExclude = [string[]]]
    [MembersToInclude = [string[]]]
    [PsDscRunAsCredential = [PSCredential]]
}

Description

리소스 Group 를 사용하면 로컬 그룹을 관리할 수 있습니다. 그룹을 만들고, 업데이트하고, 제거할 수 있습니다. 이 리소스를 사용하여 그룹 멤버 자격을 적용하고 그룹의 설명을 설정할 수 있습니다.

요구 사항

없음

키 속성

GroupName

그룹의 이름을 지정합니다.

Type: System.String

선택적 속성

자격 증명

필요한 경우 로컬이 아닌 그룹 구성원을 확인할 수 있는 권한이 있는 계정의 자격 증명을 지정합니다.

Type: System.Management.Automation.PSCredential
Default Value: None

설명

그룹의 설명을 지정합니다.

Type: System.String
Default Value: None

Ensure

그룹이 있는지 여부를 지정합니다. 그룹을 추가하거나 업데이트하려면 이 속성을 .로 Present설정합니다. 그룹을 제거하려면 이 속성을 .로 Absent설정합니다. 기본값은 Present입니다.

Type: System.String
Accepted Values:
  - Absent
  - Present
Default Value: Present

멤버

그룹 멤버의 전체 목록을 문자열 배열로 지정합니다. 이 속성을 지정하면 리소스는 그룹의 멤버 목록을 이 값으로 설정합니다. 각 멤버의 서식을 다음 중 하나로 지정합니다.

도메인 정규화된 이름: <domain>\<username>
Upn: <username>@<domain>
고유 이름: CN=<username>,DC=...
사용자 이름: <username>

MembersToExclude 또는 MembersToInclude 속성에는 이 속성을 사용하지 마세요. 이렇게 하면 리소스가 예외를 throw합니다.

Type: System.String[]
Default Value: None

MembersToExclude

그룹에서 제외할 하나 이상의 멤버를 문자열 배열로 지정합니다. 이 속성을 지정하면 리소스가 이러한 멤버를 포함하는 경우 그룹에서 이러한 멤버를 제거합니다. 각 멤버의 서식을 다음 중 하나로 지정합니다.

도메인 정규화된 이름: <domain>\<username>
Upn: <username>@<domain>
고유 이름: CN=<username>,DC=...
사용자 이름: <username>

Members 속성에는 이 속성을 사용하지 마세요. 이렇게 하면 리소스가 예외를 throw합니다.

Type: System.String[]
Default Value: None

MembersToInclude

그룹에 문자열 배열로 포함할 하나 이상의 멤버를 지정합니다. 이 속성을 지정하는 경우 리소스는 이러한 멤버를 포함하지 않는 경우 그룹에서 이러한 멤버를 추가합니다. 각 멤버의 서식을 다음 중 하나로 지정합니다.

도메인 정규화된 이름: <domain>\<username>
Upn: <username>@<domain>
고유 이름: CN=<username>,DC=...
사용자 이름: <username>