Get-SPOSite

リファレンス

モジュール:: Microsoft.Online.SharePoint.PowerShell

適用対象:: SharePoint Online

1 つ以上のサイトコレクションを返します。

構文

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>]

説明

このコマンドレットには、複数のパラメーターセットが含まれています。使用できるのは、1 つのパラメーターセットのパラメーターだけであり、異なるパラメーターセットのパラメーターを組み合わせることはできません。パラメーターセットの使用方法の詳細については、「コマンドレットパラメーターセット」を参照してください。

Get-SPOSite コマンドレットは、指定した条件と一致するすべてのサイトコレクションのプロパティを取得して返します。

SharePoint Online Management Shell のバージョン 5361 では、次の問題が発生する可能性があります。

追加のサイトコレクションが表示されます。たとえば、すべてのグループサイトおよびビデオサイトがチームサイトとともに表示されます。

Detailed パラメーターは廃止されました。このパラメーターは、以前のバージョンでは動作します。

注:

Get-SPOSite コマンドレットでは、ごみ箱の中のサイトコレクションは取得されません。

コマンドレットを実行するには、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 Management Shell バージョン 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 Management Shell のバージョン 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、定義なしです。既定では、値は定義なしです。つまり、フィルターは適用されません。

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、または 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

次の方法で共有