Get-MsolGroup
Azure Active Directory에서 그룹을 가져옵니다.
구문
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 매개 변수를 지정하지 마세요.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-GroupType
가져올 그룹의 유형을 지정합니다. 유효한 값은 Security, MailEnabledSecurity 및 DistributionList입니다.
| 형식: | GroupType |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-HasErrorsOnly
이 cmdlet은 유효성 검사 오류가 있는 그룹만 반환한다는 것을 나타냅니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-HasLicenseErrorsOnly
이 cmdlet이 라이선스 오류가 있는 보안 그룹만 반환할지 여부를 지정합니다.
| 형식: | Boolean |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-IsAgentRole
이 cmdlet은 에이전트 그룹만 반환되도록 지정합니다. 이 값은 파트너 사용자에게만 적용됩니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-MaxResults
이 cmdlet이 반환하는 최대 결과 수를 지정합니다. 기본값은 250입니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | 250 |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ObjectId
가져올 그룹의 고유 개체 ID를 지정합니다.
| 형식: | Guid |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-SearchString
문자열을 지정합니다. 이 cmdlet은 이 문자열로 시작하는 표시 이름이 있는 보안 그룹을 반환합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-TenantId
작업을 수행할 테넌트 고유 ID를 지정합니다. 기본값은 현재 사용자의 테넌트입니다. 이 매개 변수는 파트너 사용자에게만 적용됩니다.
| 형식: | Guid |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-UserObjectId
사용자의 고유 ID를 지정합니다. 이 cmdlet은 이 사용자가 속한 보안 그룹을 반환합니다. 이 매개 변수는 IsAgentRole 매개 변수와 함께 사용해야 합니다.
| 형식: | Guid |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-UserPrincipalName
사용자의 사용자 계정 이름을 지정합니다. 이 cmdlet은 이 사용자가 속한 보안 그룹을 반환합니다. 이 매개 변수는 IsAgentRole 매개 변수와 함께 사용해야 합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
출력
Microsoft.Online.Administration.Group
이 cmdlet은 다음 정보를 포함하는 그룹 목록을 반환합니다.
CommonName. 그룹의 일반 이름입니다.
설명 그룹 설명입니다.
DisplayName. 그룹의 표시 이름입니다.
Emailaddress. 그룹의 전자 메일 주소입니다. 보안 그룹에 대해서는 반환되지 않습니다.
오류. 그룹에 대한 오류 목록입니다.
GroupType입니다. 그룹의 유형입니다. 형식은 SecurityGroup, DistributionList 또는 MailEnabledSecurityGroup일 수 있습니다.
IsSystem. 이 그룹이 시스템 그룹인지 여부(Azure Active Directory에서 생성됨). 이러한 그룹은 업데이트하거나 제거할 수 없습니다.
LastDirSyncTime. 그룹을 마지막으로 동기화한 날짜와 시간입니다.
Managedby. 그룹의 소유자입니다.
Objectid. 그룹의 고유한 개체 ID입니다.
프록시 주소. 이 그룹과 연결된 프록시 주소입니다(메일 사용이 가능한 그룹에만 해당).
ValidationStatus입니다. 그룹에 오류가 발생했는지 여부입니다.