Get-SPOSite

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

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

This cmdlet contains more than one parameter set. You may only use parameters from one parameter set and you may not combine parameters from different parameter sets. For more information about how to use parameter sets, see Cmdlet Parameter Sets.

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

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

Additional site collections are now displayed. For example, all group and video sites along with team sites will be displayed.

The Detailed parameter has been deprecated. It will continue to work with earlier versions

참고

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

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

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

참고

If Site Collection Storage Management is enabled for the tenant, you will not be able to set quota and will have a generic error returned. To workaround this issue, set the site collection storage management to "manual" temporarily, set your quotas and then set the site collection storage management setting back to its original setting.

참고

제한 또는 필터 매개 변수가 제공되면 다음 사이트 모음 속성이 채워지지 않고 기본값을 포함할 수 있습니다. 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

Use this parameter to get additional property information on a site collection. You will notice a slower response time when the Detailed parameter is used.

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

  • ResourceUsageCurrent

  • ResourceUsageAverage

  • StorageUsageCurrent

  • LockIssue

  • WebsCount

  • CompatibilityLevel

  • AllowSelfServiceUpgrade

  • SiteDefinedSharingCapability

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

  • SharingCapability

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

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

-DisableSharingForNonOwnersStatus

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

참고

이 매개 변수는 SharePoint Online 관리 셸 버전 16.0.4613.1211 이상에서만 사용할 수 있습니다.

Type:SwitchParameter
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-GroupIdDefined

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

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

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

-Identity

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

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

-IncludePersonalSite

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

The values are $true and $false. By default, the value is $false which means no personal sites will be returned.

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

-Limit

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

Type:String
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

입력

Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind

출력

System.Object