다음을 통해 공유

Get-SPOUser

모듈:
Microsoft.Online.SharePoint.PowerShell Module

지정한 검색 조건과 일치하는 SharePoint Online 사용자 또는 보안 그룹 계정을 반환합니다.

구문

All (기본값) 

Get-SPOUser
    -Site <SpoSitePipeBind>
    [-Limit <String>]
    [<CommonParameters>]

ByGroup 

Get-SPOUser
    -Site <SpoSitePipeBind>
    [-Group <String>]
    [-Limit <String>]
    [<CommonParameters>]

ByLogin 

Get-SPOUser
    -Site <SpoSitePipeBind>
    [-LoginName <String>]
    [<CommonParameters>]

Description

이 cmdlet에는 둘 이상의 매개 변수 집합이 포함됩니다. 한 매개 변수 집합의 매개 변수만 사용할 수 있으며 서로 다른 매개 변수 집합의 매개 변수를 결합하면 안 됩니다. 매개 변수 집합을 사용하는 방법에 관한 자세한 내용은 Cmdlet 매개 변수 집합을 참조하세요.

Get-SPOUser cmdlet는 일치하는 사용자나 보안 그룹을 하나만 찾습니다.

적어도 SharePoint Online 관리자로 cmdlet을 실행하고 Get-SPOUser 쿼리된 사이트의 사이트 모음 관리자여야 합니다.

SharePoint Online용 Windows PowerShell의 사용 권한과 최신 정보는 SharePoint Online 관리 셸 소개의 온라인 설명서를 참조하세요.

예제

예제 1

Get-SPOUser -Site https://contoso.sharepoint.com/sites/finance

예제 1에서는 사이트 모음 https://contoso.sharepoint.com/sites/finance에서 모든 사용자 또는 보안 그룹 계정을 반환합니다.

예제 2

Get-SPOUser -Site https://contoso.sharepoint.com/sites/finance -LoginName melissa.kerr@contoso.com

예제 2는 사이트 모음 https://contoso.sharepoint.com/sites/finance에서 사용자 이름이 "melissa.kerr@contoso.com"인 사용자 또는 보안 그룹 계정을 반환합니다.

예제 3

Get-SPOUser -Site https://contoso.sharepoint.com/sites/finance -Group "Team Site Members"

예제 3에서는 사이트 모음 https://contoso.sharepoint.com/sites/finance의 Team Site Members 그룹에서 사용자 또는 보안 그룹 계정 하나를 반환합니다.

매개 변수

-Group

적용 가능: SharePoint Online

사용자를 가져올 그룹을 지정합니다.

매개 변수 속성

형식:System.String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

ByGroup
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Limit

적용 가능: SharePoint Online

반환할 최대 사용자 수를 지정합니다. 반환활 최대 사용자 수의 기본값은 500명입니다. 모든 사용자를 반환하려면 값을 "모두"로 지정합니다.

매개 변수 속성

형식:System.String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

All
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False
ByGroup
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-LoginName

적용 가능: SharePoint Online

사용자 이름을 지정합니다.

매개 변수 속성

형식:System.String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

ByLogin
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Site

적용 가능: SharePoint Online

사용자를 가져올 사이트 모음의 URL을 지정합니다.

매개 변수 속성

형식:Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.