Get-SPOExternalUser
테넌트에서 외부 사용자를 반환합니다.
구문
Default (기본값)
Get-SPOExternalUser
[[-Position] <Int32>]
[[-PageSize] <Int32>]
[[-Filter] <String>]
[[-SortOrder] <SortOrder>]
[[-SiteUrl] <String>]
[-ShowOnlyUsersWithAcceptingAccountNotMatchInvitedAccount <Boolean>]
[<CommonParameters>]
Description
cmdlet은 Get-SPOExternalUser 지정된 조건에 따라 테넌트 에 있는 외부 사용자를 반환합니다.
SharePoint Online용 Windows PowerShell의 사용 권한과 최신 정보는 https://go.microsoft.com/fwlink/p/?LinkId=251832에서 온라인 설명서를 참조하세요.
예제
예제 1
Get-SPOExternalUser -Position 0 -PageSize 2
예제 1에서는 모음에서 처음 두 명의 외부 사용자를 반환합니다.
예제 2
Get-SPOExternalUser -Position 2 -PageSize 2
예제 2에서는 모음의 세 번째 페이지에서 두 명의 외부 사용자를 반환합니다.
예제 3
Get-SPOExternalUser -Position 0 -PageSize 30 -SiteUrl https://contoso.sharepoint.com
예제 3은 SiteUrl https://contoso.sharepoint.com과 일치하는 처음 30명의 사용자를 반환합니다.
매개 변수
-Filter
적용 가능: SharePoint Online
이름, 성 또는 전자 메일 주소가 대/소문자를 구분하지 않는 비교를 사용하여 문자열의 텍스트로 시작하는 사용자로만 결과를 제한합니다.
매개 변수 속성
| 형식: | System.String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 4 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-PageSize
적용 가능: SharePoint Online
모음에서 반환할 최대 사용자 수를 지정합니다.
이 값은 50보다 작거나 같아야 합니다.
매개 변수 속성
| 형식: | System.Int32 |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 3 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Position
적용 가능: SharePoint Online
반환할 첫 번째 결과의 정렬된 모음에서 위치를 나타내는 인덱스(0부터 시작)를 지정하려면 사용합니다.
매개 변수 속성
| 형식: | System.Int32 |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 2 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ShowOnlyUsersWithAcceptingAccountNotMatchInvitedAccount
적용 가능: SharePoint Online
초대를 수락했지만 초대가 전송된 계정을 사용하지 않는 사용자를 표시합니다.
매개 변수 속성
| 형식: | System.Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-SiteUrl
적용 가능: SharePoint Online
외부 사용자를 검색할 사이트를 지정합니다.
사이트가 지정되지 않은 경우 모든 사이트에 대한 외부 사용자가 반환됩니다.
매개 변수 속성
| 형식: | System.String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 6 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-SortOrder
적용 가능: SharePoint Online
SPOUser.Email 속성에 대한 결과를 오름차순으로 정렬할지 내림차순으로 정렬할지 지정합니다.
매개 변수 속성
| 형식: | Microsoft.Online.SharePoint.TenantManagement.SortOrder |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 5 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.