Get-SPSite

構文

Get-SPSite
   [-Identity] <SPSitePipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-Regex]
   [-WhatIf]
   [<CommonParameters>]

Get-SPSite
   -ContentDatabase <SPContentDatabasePipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WhatIf]
   [-NeedsB2BUpgrade]
   [<CommonParameters>]

Get-SPSite
   -SiteSubscription <SPSiteSubscriptionPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WhatIf]
   [<CommonParameters>]

Get-SPSite
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CompatibilityLevel <Int32>]
   [-Confirm]
   [-Filter <ScriptBlock>]
   [-Limit <String>]
   [-WebApplication <SPWebApplicationPipeBind>]
   [-WhatIf]
   [<CommonParameters>]

説明

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

Get-SPSite コマンドレットでは、Identity パラメーターに一致する単一のサイト、または指定された範囲で Filter パラメーターに一致するすべてのサイトを取得します。 範囲は、WebApplication パラメーター、ContentDatabase パラメーター、および SiteSubscription パラメーターで指定します。 これらの範囲のいずれも指定しない場合の範囲はファームとなります。 Filter パラメーターを使用しないで範囲を指定した場合、この範囲に含まれるすべてのサイトが返されます。

Identity パラメーターには、ワイルドカード文字 (*) で終わる部分的な URL を指定することができます。 指定した範囲でこの部分的な URL と一致するすべてのサイト コレクションが取得されます。 さらに、Regex パラメーターを指定すると、Identity パラメーターは正規表現として扱われ、指定した範囲でこの式と一致する URL を持つすべてのサイト コレクションが取得されます。

Filter パラメーターは、コンテンツ データベースに格納されている特定のサイト コレクション プロパティのサーバー側フィルターです。Filter パラメーターがない場合、これらのプロパティに対するフィルター処理は遅いプロセスです。 これらのサイト コレクションのプロパティは、Owner、SecondaryContact、LockState です。 Filter パラメーターは、Where-Object ステートメントと同じ構文を使用するスクリプト ブロックですが、より高速な結果を得るにはサーバー上で実行されます。

LockState の有効な値は、Unlock、NoAdditions、ReadOnly、および NoAccess です。

Get-SPSite コマンドレットが戻すすべてのサイト コレクションは、パイプラインの最後で自動的に破棄されます。 Get-SPSite の結果をローカル変数に格納するには、メモリ リークを防ぐ目的で Start-SPAssignment コマンドレットと Stop-SPAssignment コマンドレットを使用します。

Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンライン ドキュメントをご覧ください。

例

------------------ 例 1 ---------------------

Get-SPSite 'https://<site name>' | Get-SPWeb -Limit All | Select Title

次の使用例は、サイト コレクション内のサブ Web タイトルのコレクション https://< サイト名で取得します>。

------------------ 例 2 ---------------------

Get-SPSite -ContentDatabase "b399a366-d899-4cff-8a9b-8c0594ee755f" | Format-Table -Property Url, Owner, SecondaryContact

この例では、コンテンツ データベース b399a366-d899-4cff-8a9b-8c0594ee755f 内のすべてのサイトからデータのサブセットを取得します。

------------------ 例 3 ---------------------

Start-SPAssignment -Global
$s = Get-SPSite -Identity https://<MyApp>/Sites/Site1
$s.Url
Stop-SPAssignment -Global

この例では、Identity パラメーターで指定したサイトを取得し、その結果を変数 s に挿入します。

前の例では、割り当てコレクションの Global メソッドを使用しています。 Global メソッドは簡単に使用できますが、サイズが急激に大きくなります。 グローバル割り当てが有効な場合、多数の結果を返す Get-SPSite コマンドは実行しないでください。

------------------ 例 4 ---------------------

$GC = Start-SPAssignment
$Sites = $GC | Get-SPSite -Filter {$_.Owner -eq "DOMAIN\JDow"} -Limit 50
Stop-SPAssignment $GC

この例では、サーバー側のクエリを使用して、ユーザー DOMAIN\JDow が所有する最初の 50 個のサイトを取得し、それをローカル変数に割り当てます。

この例では、高度な割り当てコレクション メソッドを使用しています。

------------------ 例 5 ---------------------

Get-SPWebApplication https://<site name> | Get-SPSite -Limit All |ForEach-Object {$sum=0}{ $sum+=$_.Usage.Storage }{$sum}

この例では、指定した Web アプリケーションのすべてのサイトについてディスク領域の使用状況の集計結果を取得するコマンドを示します。

------------------ 例 6 ---------------------

Get-SPSite -Identity "https://localserver/(my|personal)/sites" -Regex

この例では、指定した正規表現と一致するすべてのサイトを取得します。

Regex パラメーターを使用する場合は、Identity パラメーターで引用符を使用する必要があります。

------------------ 例 7 ---------------------

Get-SPSite https://<site name>/sites/teams/* -Limit 100

この例では、URL の下にあるサイトの最大 100 個を取得します https://sitename/sites/teams.

------------------ 例 8 ---------------------

Get-SPSite | select url, @{Expression={$_.Usage.Storage}}

この例では、.UsageInfo プロパティの Storage フィールドを使用して、サイト コレクションによって使用されている記憶域の量を取得します。

------------------EXAMPLE 9---------------------

Get-SPSite -Limit all -CompatibilityLevel 14

次の使用例は、すべての SharePoint Server モードサイト コレクションを返します。

パラメーター

-AssignmentCollection

-CompatibilityLevel

-Confirm

-ContentDatabase

-Filter

-Identity

-Limit

-NeedsB2BUpgrade

-Regex

-SiteSubscription

-WebApplication

-WhatIf