Get-SPOSite

モジュール:

Microsoft.Online.SharePoint.PowerShell Module

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

構文

ParamSet1 (既定)

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

ParamSet3

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

ParamSet2

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

説明

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

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

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

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

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

注:

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

SharePoint ドメイン名を変更した後に作成されたサイト リダイレクトは、このコマンドレットを使用して取得されます。

コマンドレットを実行するには、SharePoint Online 管理者であり、サイト コレクション管理者である必要があります。

SharePoint Online の Windows PowerShell のアクセス許可と最新の情報については、「SharePoint Online 管理シェルの概要」を参照してください。

注:

テナントに対するサイト コレクションの記憶域の管理が有効になっていると、クォータの設定はできず、一般エラーが返されます。 この問題を回避するには、サイト コレクションのストレージ管理を一時的に "手動" に設定し、クォータを設定してから、サイト コレクションのストレージ管理設定を元の設定に戻します。

注:

Limit パラメーターまたは Filter パラメーターが指定されている場合、次のサイト コレクションのプロパティは設定されず、既定値が含まれる場合があります: 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

次の使用例は、サイトに関連付けられている InformationSegment を返します。 これは、Microsoft 365 の情報バリア機能を有効にしたテナントに適用されます。 SharePoint Online の情報バリアを理解するには、「 情報バリアについて学習 する」を参照してください。

注: このプロパティは、バージョン 16.0.19927.12000 以降SharePoint Online 管理シェルでのみ使用できます。

例 7

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

この例では、サーバー側のフィルタリングを使用して、18 に一致するサイトを返します。

例 8

Get-SPOSite -Filter { IsAuthoritative -eq true }

この例では、サーバー側のフィルター処理を使用して、権限のあるサイト (つまり、IsAuthoritative プロパティが true に設定されているサイト) を返します。

例 9

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

この例では、クライアント側のフィルタリングを使用して、Microsoft Teams に接続されているサイトのリストを返します。

例 10.

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

この例では、クライアント側のフィルタリングを使用して、Microsoft Teams のプライベート チャネルまたは共有チャネルに接続されているサイトのリストを返します。

例 11

Get-SPOSite -Limit ALL -GroupIdDefined $true

この例では、サーバー側のフィルタリングを使用して、Microsoft 365 グループが関連付けられているすべてのサイトを返します。

例 12

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

次の使用例は、変数を使用して、指定した所有者によってフィルター処理されているすべてのサイトを取得します。

パラメーター

-ArchiveStatus

適用対象: SharePoint Online

特定のアーカイブ状態のサイトを表示します。 たとえば、NotArchived、RecentlyArchived、FullyArchived、Archived、Reactivating などです。

パラメーターのプロパティ

型:	Microsoft.Online.SharePoint.PowerShell.ArchiveStatusFilterType
規定値:	None
指定可能な値:	NotArchived, FullyArchived, RecentlyArchived, Reactivating, Archived
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

ParamSet2

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Detailed

適用対象: SharePoint Online

サイト コレクションに対する追加のプロパティ情報を取得するには、このパラメーターを使用します。 Detailed パラメーターを使用すると、応答時間が遅くなります。

次のプロパティが取得されます。

• ResourceUsageCurrent
• ResourceUsageAverage
• StorageUsageCurrent
• LockIssue
• WebsCount
• CompatibilityLevel
• AllowSelfServiceUpgrade
• SiteDefinedSharingCapability

サイト ポリシーの保存されている値を返します。

• SharingCapability

サイト ポリシーとテナント ポリシーを組み合わせた、有効なアクセス レベルを返します。

パラメーターのプロパティ

型:	System.Management.Automation.SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

ParamSet1

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

ParamSet2

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-DisableSharingForNonOwnersStatus

適用対象: SharePoint Online

このパラメーターでは、所有者以外は共有できなくなります。

注:

このパラメーターは、SharePoint Online Management Shell のバージョン 16.0.4613.1211 以降でのみ使用できます。 DisableSharingForNonOwnersStatus は、永続化された設定ではなく、サイト コレクションの状態の分析です。 この目的は、この設定を取得することです。また、返される他の設定が正しいことを保証するものではありません。 その他の設定と値を取得するには、このパラメーターを指定せずに Get-SPOSite を使用して、すべてが正しく表示されていることを確認します。

パラメーターのプロパティ

型:	System.Management.Automation.SwitchParameter
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

ParamSet3

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Filter

適用対象: SharePoint Online

適用するサーバー側フィルターのスクリプト ブロックを指定します。 この型は、{ PropertyName <operator> "filterValue"} という形式の有効なフィルター名と値であることが必要です。 有効な演算子は、-eq、-ne、-like、-notlike です。 現時点では、所有者、テンプレート (フィルターに存在する唯一のプロパティの場合はフィルターに使用できます)、LockState、Url、IsAuthoritative (比較演算子 -eq と -ne のみをサポート) でフィルター処理できます。 -or 演算子を使用して追加のフィルターを含めることはサポートされていません。

注: 演算子の値では大文字と小文字が区別されます。

パラメーターのプロパティ

型:	System.String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

ParamSet2

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-GroupIdDefined

適用対象: SharePoint Online

値が $true に設定されている場合に、グループ ID を持つサイト (つまり、Microsoft 365 グループに接続されているサイト) に返されるサイトのリストをフィルタリングします。 値が $false の場合、サイトのリストをグループ ID のないサイトのみにフィルタリングします。

値は $true、$false、定義なしです。 既定では、値は定義なしです。つまり、フィルターは適用されません。

パラメーターのプロパティ

型:	System.Boolean
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

ParamSet2

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Identity

適用対象: SharePoint Online

サイト コレクションの URL を指定します。

パラメーターのプロパティ

型:	Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

ParamSet1

配置:	0
必須:	False
パイプラインからの値:	True
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

ParamSet3

配置:	0
必須:	False
パイプラインからの値:	True
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-IncludePersonalSite

適用対象: SharePoint Online

値が $true に設定されている場合、個人用サイトを表示します。

有効な値は、$true と $false です。 既定の値は $false で、個人用サイトは返されません。

パラメーターのプロパティ

型:	System.Boolean
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

ParamSet2

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-IsAuthoritative

適用対象: SharePoint Online

IsAuthoritative プロパティが true に設定されているサイトの一覧をフィルター処理します。 IsAuthoritative が true の場合、Microsoft Search、Copilot (BizChat)、およびその他の AI エージェントに、サイトのコンテンツが公式で信頼され、検証されていることを通知します。

パラメーターのプロパティ

型:	Boolean
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

ParamSet1

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Limit

適用対象: SharePoint Online

取得するサイト コレクションの最大数を指定します。 任意の数を指定できます。 すべてのサイト コレクションを取得するには、ALL を指定します。 既定値は 200 です。 このパラメーターを指定すると、一部のサイト コレクション プロパティは入力されず、既定値が含まれる場合があります。

パラメーターのプロパティ

型:	System.String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

ParamSet1

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

ParamSet2

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

-Template

適用対象: SharePoint Online

特定のテンプレートのサイトを表示します。 たとえば、STS、STS#0、STS#1、STS#3、GROUP#0、SRCHCEN#0、または SITEPAGEPUBLISHING#0 です。

パラメーターのプロパティ

型:	System.String
規定値:	None
ワイルドカードのサポート:	False
DontShow:	False

パラメーター セット

ParamSet2

配置:	Named
必須:	False
パイプラインからの値:	False
プロパティ名別のパイプラインからの値:	False
残りの引数からの値:	False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。

入力

Microsoft.Online.SharePoint.PowerShell.SpoSitePipeBind

出力

System.Object