Get-AzureADMSGroup

  • 참조
모듈:
AzureADPreview

Azure AD의 그룹에 대한 정보를 가져옵니다.

구문

Get-AzureADMSGroup
   [-All <Boolean>]
   [-Top <Int32>]
   [-Select <String>]
   [-Filter <String>]
   [<CommonParameters>]
Get-AzureADMSGroup
   [-SearchString <String>]
   [-All <Boolean>]
   [<CommonParameters>]
Get-AzureADMSGroup
   -Id <String>
   [-All <Boolean>]
   [-Select <String>]
   [<CommonParameters>]

Description

Get-AzureADMSGroup cmdlet은 Azure AD(Azure Active Directory)의 그룹에 대한 정보를 가져옵니다. 그룹을 가져오려면 Id 매개 변수를 지정합니다. SearchString 또는 Filter 매개 변수를 지정하여 특정 그룹을 찾습니다. 매개 변수를 지정하지 않으면 이 cmdlet은 모든 그룹을 가져옵니다.

예제

예제 1: 모든 그룹 가져오기

PS C:\> Get-AzureADMSGroup

Id                            : d539a25e-2db2-482a-9dcb-2a0b27fe4f27 
Description                   : 
OnPremisesSyncEnabled         : 
DisplayName                   : 
ADSyncOperators 
OnPremisesLastSyncDateTime    : 
Mail                          : 
MailEnabled                   : False
MailNickname                  : ADSyncOperators 
OnPremisesSecurityIdentifier  : S-1-5-21-2695029449-1154706203-1063139792-1243 
ProxyAddresses                : {} 
SecurityEnabled               : True 
GroupTypes                    : {} 
MembershipRule                : 
MembershipRuleProcessingState :


Id                            : d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b 
Description                   : 
OnPremisesSyncEnabled         : 
DisplayName                   : Project Icarus 
OnPremisesLastSyncDateTime    : 
Mail                          : 
MailEnabled                   : False 
MailNickname                  : 60f3d02c-0c6e-41da-bb64-128c73b4d9e6 
OnPremisesSecurityIdentifier  : 
ProxyAddresses                : {} 
SecurityEnabled               : True 
GroupTypes                    : {DynamicMembership} 
MembershipRule                : (user.jobtitle -eq "Sales manager") -or ((user.department -eq "Marketing") -and (user.country -eq "Greece")) 
MembershipRuleProcessingState : On

이 명령은 Azure AD의 모든 그룹을 가져옵니다.

예제 2: ID를 사용하여 특정 그룹 가져오기

PS C:\> Get-AzureADMSGroup -Id "d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b"

Id                            : d98ddc78-6e8d-4f0d-8a3f-b923c6ebc14b 
Description                   : 
OnPremisesSyncEnabled         : 
DisplayName                   : Project Icarus 
OnPremisesLastSyncDateTime    : 
Mail                          : 
MailEnabled                   : False 
MailNickname                  : 60f3d02c-0c6e-41da-bb64-128c73b4d9e6 
OnPremisesSecurityIdentifier  : 
ProxyAddresses                : {} 
SecurityEnabled               : True 
GroupTypes                    : {DynamicMembership} 
MembershipRule                : (user.jobtitle -eq "Sales manager") -or ((user.department -eq "Marketing") -and (user.country -eq "Greece")) 
MembershipRuleProcessingState : On

이 명령은 지정된 ID가 있는 그룹에 대한 정보를 가져옵니다.

예제 3: 모든 그룹에 대한 AssignedLabels 및 DisplayName 속성 값 가져오기

PS C:\> Get-AzureADMSGroup -Select "AssignedLabels,DisplayName"

AssignedLabels                : [{LabelId: "00000000-0000-0000-0000-000000000000", DisplayName: "Confidential"}]
DisplayName                   : Project Icarus 1

AssignedLabels                : [{LabelId: "00000000-0000-0000-0000-000000000000", DisplayName: "Confidential"}]
DisplayName                   : Project Icarus 2

이 명령은 모든 그룹에 대한 AssignedLabels 및 DisplayName 속성 값을 가져옵니다.

AssignedLabels 그룹 속성은 Select 매개 변수에서만 검색할 수 있습니다.

예제 4: 그룹에 대한 AssignedLabels 및 DisplayName 속성 값 가져오기

PS C:\> Get-AzureADMSGroup -Id "11111111-1111-1111-1111-111111111111" -Select "AssignedLabels,DisplayName"

AssignedLabels                : [{LabelId: "00000000-0000-0000-0000-000000000000", DisplayName: "Confidential"}]
DisplayName                   : Project Icarus 1

이 명령은 특정 그룹에 대한 AssignedLabels 및 DisplayName 속성 값을 가져옵니다.

AssignedLabels 그룹 속성은 Select 매개 변수에서만 검색할 수 있습니다.

매개 변수

-All

true이면 모든 그룹을 반환합니다. false이면 Top 매개 변수로 지정된 개체 수를 반환합니다.

형식:Boolean
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Filter

그룹 집합과 일치하도록 oData v3.0 필터 문자열을 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Id

이 cmdlet이 가져오는 그룹의 ID를 지정합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-SearchString

검색 문자열을 지정합니다. 이 cmdlet은 검색 문자열과 일치하는 DisplayName 또는 Description 특성이 있는 그룹을 가져옵니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Select

검색할 그룹 속성 목록을 지정합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Top

이 cmldet이 가져오는 최대 레코드 수를 지정합니다. 기본값은 100입니다.

형식:Int32
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

입력

String

System.Nullable'1[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

출력

Object

참고

이 cmdlet은 현재 공개 미리 보기로 제공됩니다. cmdlet이 공개 미리 보기에 있는 동안 예기치 않은 영향을 줄 수 있는 cmdlet을 변경할 수 있습니다. 프로덕션 환경에서는 이 cmdlet을 사용하지 않는 것이 좋습니다.