Get-SPOSite

참조

모듈:: Microsoft.Online.SharePoint.PowerShell

적용 대상:: SharePoint Online

하나 이상의 사이트 모음을 반환합니다.

Syntax

Get-SPOSite
   [[-Identity] <SpoSitePipeBind>]
   [-Detailed]
   [-Limit <String>]
   [<CommonParameters>]

Get-SPOSite
   [-Detailed]
   [-Filter <String>]
   [-IncludePersonalSite <Boolean>]
   [-Limit <String>]
   [-Template <String>]
   [-GroupIdDefined]
   [<CommonParameters>]

Get-SPOSite
   [-Identity] <SpoSitePipeBind>
   [-DisableSharingForNonOwnersStatus]
   [<CommonParameters>]

Description

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

Get-SPOSite cmdlet은 지정한 조건과 일치하는 모든 사이트 모음의 속성을 검색하고 반환합니다.

버전 5361의 SharePoint Online 관리 셸을 사용하면 다음을 경험할 수 있습니다.

이제 추가 사이트 모음이 표시됩니다. 예를 들면 팀 사이트와 함께 모든 그룹 및 비디오 사이트가 표시됩니다.

Detailed 매개 변수는 사용되지 않습니다. 이전 버전에서 계속 작업할 수 있습니다.

참고

휴지통의 사이트 모음은 Get-SPOSite cmdlet으로 검색되지 않습니다.

cmdlet을 실행하려면 SharePoint Online 관리자 또는 전역 관리자이고, 사이트 모음 관리자여야 합니다.

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

참고

사이트 모음 저장소 관리가 테넌트에 대해 사용하도록 설정되어 있으면, 할당량을 설정할 수 없으며 일반 오류가 반환됩니다. 이 문제를 해결하려면 사이트 모음 스토리지 관리를 일시적으로 "수동"으로 설정하고 할당량을 설정한 다음 사이트 모음 스토리지 관리 설정을 원래 설정으로 다시 설정합니다.

참고

제한 또는 필터 매개 변수가 제공되면 다음 사이트 모음 속성이 채워지지 않으며 기본값인 AllowDownloadingNonWebViewableFiles가 포함될 수 있습니다. AllowEditing, AllowSelfServiceUpgrade, AnonymousLinkExpirationInDays, ConditionalAccessPolicy, DefaultLinkPermission, DefaultLinkToExistingAccess, DefaultSharingLinkType, DenyAddAndCustomizePages, DisableCompanyWideSharingLinks, ExternalUserExpirationInDays, InformationSegment, LimitedAccessFileType, OverrideTenantAnonymousLinkExpirationPolicy, OverrideTenantExternalUserExpirationPolicy, PWAEnabled, SandboxedCodeActivationCapability, SensitivityLabel, SharingAllowedDomainList, SharingBlockedDomainList, SharingCapability, SharingDomainRestrictionMode.

예제

-----------------------예제 1-----------------------------

Get-SPOSite

예제 1에서는 모든 사이트 모음을 반환합니다.

-----------------------예제 2-----------------------------

Get-SPOSite -Identity https://contoso.sharepoint.com

예제 2에서는 자세한 속성과 함께 사이트 모음을 나열합니다.

-----------------------예제 3-----------------------------

Get-SPOSite -Identity https://contoso.sharepoint.com -DisableSharingForNonOwnersStatus

예제 3은 사이트 모음의 소유자가 아닌 사용자가 사이트 모음을 공유할 수 있는지 여부의 상태를 업데이트합니다(이 값을 설정하지 않음).

-----------------------예제 4-----------------------------

Get-SPOSite -Template GROUP#0 -IncludePersonalSite:$false

이 예제에서는 테넌트에서 그룹 사이트 모음을 열거합니다.

-----------------------예제 5-----------------------------

Get-SPOSite -Identity https://contoso.sharepoint.com/sites/groupname -detailed |fl

이 예제에서는 그룹 사이트에 대한 할당량 정보를 가져옵니다.

-----------------------예제 6-----------------------------

Get-SPOSite -Identity https://contoso.sharepoint.com/sites/research | Select InformationSegment

이 예제에서는 사이트와 연결된 InformationSegments를 반환합니다. Microsoft 365 정보 장벽 기능을 사용하도록 설정한 테넌트에게 적용됩니다. SharePoint Online 의 정보 장벽을 이해하려면 정보 장벽에 대해 알아봅니 다.

참고: 이 속성은 SharePoint Online 관리 셸 버전 16.0.19927.12000 이상에서만 사용할 수 있습니다.

-----------------------예제 7-----------------------------

Get-SPOSite -Filter { Url -like "contoso.sharepoint.com/sites/18" }

이 예제에서는 서버 쪽 필터링을 사용하여 18과 일치하는 사이트를 반환합니다.

-----------------------예제 8-----------------------------

Get-SPOSite -Limit ALL | ?{$_.IsTeamsConnected -eq $true}

이 예제에서는 클라이언트 쪽 필터링을 사용하여 Microsoft Teams에 연결된 사이트 목록을 반환합니다.

-----------------------예제 9-----------------------------

Get-SPOSite -Limit ALL | ?{$_.IsTeamsChannelConnected -eq $true}

이 예제에서는 클라이언트 쪽 필터링을 사용하여 Microsoft Teams 비공개 또는 공유 채널에 연결된 사이트 목록을 반환합니다.

-----------------------예제 10-----------------------------

Get-SPOSite -Limit ALL -GroupIdDefined $true

이 예제에서는 서버 쪽 필터링을 사용하여 연결된 Microsoft 365 그룹이 있는 모든 사이트를 반환합니다.

-----------------------EXAMPLE 11-----------------------------

$userUPN="joe.healy@contoso.com"
Get-SPOSite -Filter "Owner -like '$($userUPN)'"

다음은 변수를 사용하여 지정된 소유자가 필터링하는 모든 사이트를 검색하는 예제입니다.

매개 변수

-Detailed

사이트 모음에 대한 추가 속성 정보를 가져오려면 이 매개 변수를 사용합니다. Detailed 매개 변수를 사용할 경우 응답 시간이 길어질 수 있습니다.

반환되는 속성은 다음과 같습니다.

ResourceUsageCurrent
ResourceUsageAverage
StorageUsageCurrent
LockIssue
WebsCount
CompatibilityLevel
AllowSelfServiceUpgrade
SiteDefinedSharingCapability

사이트 정책의 저장된 값을 반환합니다.

SharingCapability

유효한 액세스 수준, 즉 결합된 사이트 정책 및 테넌트 정책을 반환합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-DisableSharingForNonOwnersStatus

이 매개 변수는 비소유자가 공유할 수 없게 합니다.

참고

이 매개 변수는 SharePoint Online 관리 셸 버전 16.0.4613.1211 이상에서만 사용할 수 있습니다. DisableSharingForNonOwnersStatus는 지속형 설정이 아니라 사이트 모음의 상태를 분석하는 것입니다. 이 설정의 목적은 이 설정을 가져오는 것이며 반환된 다른 설정이 정확하다고 보장되지는 않습니다. 다른 설정 및 값을 얻으려면 이 매개 변수 없이 Get-SPOSite 사용하여 모든 항목이 올바르게 표시되는지 확인합니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-Filter

적용할 서버 쪽 필터의 스크립트 블록을 지정합니다. 형식은 { PropertyName <operator> "filterValue"} 형식의 유효한 필터 이름 및 값이어야 합니다. 유효한 연산자는 -eq, -ne, -like, -notlike입니다. 현재 소유자, 템플릿(필터에 있는 유일한 속성인 경우 필터링하는 데 사용할 수 있음), LockState, Url 등의 속성을 기준으로 필터링할 수 있습니다. -or 연산자를 사용하여 추가 필터를 포함하는 것은 지원되지 않습니다.

참고: 연산자 값은 대/소문자를 구분합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-GroupIdDefined

값이 $true로 설정된 경우 그룹 ID(예: Microsoft 365 그룹에 연결된 사이트)를 사용하여 사이트로 반환되는 사이트 목록을 필터링합니다. 값이 $false인 경우 그룹 ID가 없는 사이트로만 사이트 목록을 필터링합니다.

값은 $true, $false 및 not defined입니다. 기본적으로 값은 not defined이고, 이는 필터가 적용되지 않음을 의미합니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-Identity

사이트 모음의 URL을 지정합니다.

Type:	SpoSitePipeBind
Position:	0
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Online

-IncludePersonalSite

값이 $true로 설정되면 개인 사이트를 표시합니다.

사용 가능한 값은 $true 및 $false입니다. 기본적으로 이 값은 개인 사이트가 반환되지 않음을 의미하는 $false입니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-Limit

반환할 최대 사이트 모음 수를 지정합니다. 모든 숫자를 지정할 수 있습니다. 모든 사이트 모음을 검색하려면 ALL을 사용합니다. 기본값은 200입니다. 이 매개 변수가 제공되면 일부 사이트 모음 속성이 채워지지 않으며 기본값이 포함될 수 있습니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

-Template

특정 템플릿의 사이트를 표시합니다. 예: STS, STS#0, STS#1, STS#3, GROUP#0, SRCHCEN#0 or SITEPAGEPUBLISHING#0.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Online

입력

Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind

출력

System.Object