Get-SPAlternateURL

指定した条件のセットと一致するすべての代替 URL を取得します。

構文

Get-SPAlternateURL
   [[-Identity] <SPAlternateUrlPipeBind>]
   -ResourceName <String>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Zone <SPUrlZone>]
   [<CommonParameters>]
Get-SPAlternateURL
   [[-Identity] <SPAlternateUrlPipeBind>]
   -WebApplication <SPWebApplicationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Zone <SPUrlZone>]
   [<CommonParameters>]

説明

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

Get-SPAlternateURL コマンドレットは、Identity パラメーター (省略可) で指定した範囲、または WebApplication パラメーター、Zone パラメーター、Resource パラメーターの任意の組み合わせで指定した範囲と一致するすべての代替 URL を取得します。 条件を追加すると、範囲が絞り込まれます。 条件を指定しない場合は、すべての代替 URL が取得されます。

Identity パラメーターを使用した場合は、一致する特定の代替 URL だけが取得されます。 指定した ID を持つ代替 URL が指定した範囲に存在しない場合は、何も取得されません。

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

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

Get-SPAlternateURL -WebApplication https://sitename

この例では、指定した Web アプリケーションの代替 URL をすべて表示します。

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

Get-SPAlternateURL -ResourceName "MyResource"

この例では、指定したリソースの代替 URL をすべて表示します。

パラメーター

-AssignmentCollection

適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。 メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。

Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。 Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

取得する代替 URL の URL または GUID を指定します。

型は、フォーム 12345678-90ab-cdef-1234-567890bcdefgh 形式の有効な GUID または有効な URL である必要があります。 https://server_name.

Type:SPAlternateUrlPipeBind
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ResourceName

代替 URL の取得元のリソースの名前を指定します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WebApplication

代替 URL の取得元の Web アプリケーションを指定します。

Type:SPWebApplicationPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Zone

代替 URL が関連付けられている 5 つの領域の 1 つを指定します。

指定できる有効な領域は、 Default (既定)、 Intranet (イントラネット)、 Internet (インターネット)、 Extranet (エクストラネット)、 Custom (ユーザー設定) です。

Type:SPUrlZone
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019