Get-MsolGroup

  • 참조
모듈:
MSOnline

Azure Active Directory에서 그룹을 가져옵니다.

Syntax

Get-MsolGroup
   [-UserObjectId <Guid>]
   [-IsAgentRole]
   [-UserPrincipalName <String>]
   [-GroupType <GroupType>]
   [-HasErrorsOnly]
   [-HasLicenseErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolGroup
   -ObjectId <Guid>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolGroup
   [-UserObjectId <Guid>]
   [-IsAgentRole]
   [-UserPrincipalName <String>]
   [-GroupType <GroupType>]
   [-HasErrorsOnly]
   [-HasLicenseErrorsOnly <Boolean>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

Get-MsolGroup cmdlet은 Azure Active Directory에서 그룹을 가져옵니다. ObjectId 매개 변수를 지정하는 경우 단일 그룹을 반환하거나 모든 그룹 내에서 검색하는 데 이 cmdlet을 사용할 수 있습니다.

예제

예제 1: ID를 사용하여 그룹 가져오기

PS C:\> Get-MsolGroup -ObjectId af407072-7ae1-4b07-a0ca-6634b7396054

이 명령은 지정된 ID가 있는 그룹 개체를 반환합니다.

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

PS C:\> Get-MsolGroup

이 명령은 테넌트에 대한 전체 그룹 집합을 기본 250개 결과까지 반환합니다.

예제 3: 사용자 계정 이름을 사용하여 그룹 가져오기

PS C:\> Get-MsolGroup -isAgentRole -UserPrincipalName "pattifuller@contoso.com"

이 명령은 사용자가 구성원인 에이전트 그룹을 반환하며, 파트너 권한이 있는 회사에만 적용됩니다.

매개 변수

-All

이 cmdlet이 찾은 모든 결과를 반환한다는 것을 나타냅니다. 이 매개 변수와 MaxResults 매개 변수를 지정하지 마세요.

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

-GroupType

가져올 그룹의 형식을 지정합니다. 유효한 값은 Security, MailEnabledSecurity 및 DistributionList입니다.

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

-HasErrorsOnly

이 cmdlet은 유효성 검사 오류가 있는 그룹만 반환한다는 것을 나타냅니다.

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

-HasLicenseErrorsOnly

이 cmdlet이 라이선스 오류가 있는 보안 그룹만 반환할지 여부를 지정합니다.

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

-IsAgentRole

이 cmdlet은 에이전트 그룹만 반환되도록 지정합니다. 이 값은 파트너 사용자에게만 적용됩니다.

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

-MaxResults

이 cmdlet에서 반환하는 최대 결과 수를 지정합니다. 기본값은 250입니다.

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

-ObjectId

가져올 그룹의 고유 개체 ID를 지정합니다.

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

-SearchString

문자열을 지정합니다. 이 cmdlet은 이 문자열로 시작하는 표시 이름이 있는 보안 그룹을 반환합니다.

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

-TenantId

작업을 수행할 테넌트 고유 ID를 지정합니다. 기본값은 현재 사용자의 테넌트입니다. 이 매개 변수는 파트너 사용자에게만 적용됩니다.

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

-UserObjectId

사용자의 고유 ID를 지정합니다. 이 cmdlet은 이 사용자가 속한 보안 그룹을 반환합니다. 이 매개 변수는 IsAgentRole 매개 변수와 함께 사용해야 합니다.

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

-UserPrincipalName

사용자의 사용자 계정 이름을 지정합니다. 이 cmdlet은 이 사용자가 속한 보안 그룹을 반환합니다. 이 매개 변수는 IsAgentRole 매개 변수와 함께 사용해야 합니다.

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

출력

Microsoft.Online.Administration.Group

이 cmdlet은 다음 정보를 포함하는 그룹 목록을 반환합니다.

  • CommonName. 그룹의 일반 이름입니다.

  • 설명 그룹 설명입니다.

  • DisplayName. 그룹의 표시 이름입니다.

  • Emailaddress. 그룹의 전자 메일 주소입니다. 보안 그룹에 대해서는 반환되지 않습니다.

  • 오류. 그룹에 대한 오류 목록입니다.

  • GroupType입니다. 그룹의 유형입니다. SecurityGroup, DistributionList 또는 MailEnabledSecurityGroup 유형일 수 있습니다.

  • IsSystem. 이 그룹이 시스템 그룹인지 여부(Azure Active Directory에서 생성됨). 이러한 그룹은 업데이트하거나 제거할 수 없습니다.

  • LastDirSyncTime. 그룹을 마지막으로 동기화한 날짜와 시간입니다.

  • Managedby. 그룹의 소유자입니다.

  • Objectid. 그룹의 고유한 개체 ID입니다.

  • 프록시 주소입니다. 이 그룹과 연결된 프록시 주소입니다(메일 사용 가능 그룹에만 해당).

  • ValidationStatus입니다. 그룹에 오류가 발생했는지 여부입니다.