Get-SPOSite

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