Get-AzureADMSGroup

  • 참조
모듈:
AzureAD

MS Graph를 통해 Microsoft Entra ID의 그룹에 대한 정보를 가져옵니다.

Syntax

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

Description

Get-AzureADMSGroup cmdlet은 Microsoft Graph를 사용하여 Microsoft Entra ID의 그룹에 대한 정보를 가져옵니다. 그룹을 가져오려면 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

이 명령은 Microsoft Entra ID의 모든 그룹을 가져옵니다.

예제 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가 있는 그룹에 대한 정보를 가져옵니다.

매개 변수

-All

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Filter

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Id

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SearchString

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Top

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

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

입력

String

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

출력

Object

참고

Get-AzureADMSGroup에서 Microsoft Graph PowerShell로 마이그레이션 가이드를 참조하세요.

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