New-SPAlternateURL

構文

New-SPAlternateURL
   [-Url] <String>
   -WebApplication <SPWebApplicationPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Internal]
   [-WhatIf]
   [-Zone <SPUrlZone>]
   [<CommonParameters>]

New-SPAlternateURL
   [-Url] <String>
   -ResourceName <String>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Internal]
   [-WhatIf]
   [-Zone <SPUrlZone>]
   [<CommonParameters>]

説明

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

New-SPAlternateUrl コマンドレットでは、指定した Web アプリケーション領域やリソースの新しいパブリック URL または内部 URL を作成します。 外部リソースの代替 URL には、ResourceName パラメーターを使用します。

Web アプリケーションごとに、内部 URL とパブリック URL とのマッピングのコレクションを関連付けることができます。 内部 URL とパブリック URL の両方が、完全な URL のプロトコルとドメイン部分で構成されます。たとえば、 https://www.fabrikam.comです。 ユーザーが SharePoint サイトにアクセスするためのパブリック URL を入力すると、その URL がページのリンクに表示されます。 内部 URL は、SharePoint サイトに送信される URL 要求に含まれています。 多くの内部 URL は、マルチサーバー ファームの 1 つのパブリック URL に関連付けることができます。たとえば、ロード バランサーが要求を特定の IP アドレスにルーティングして負荷分散クラスター内のさまざまなサーバーにルーティングする場合などです。

各 Web アプリケーションでは、URL ごとに 5 つのマッピング コレクションがサポートされます。5 つのコレクションは、5 つのゾーン (既定、イントラネット、エクストラネット、インターネット、カスタム) に対応しています。 Web アプリケーションが特定のゾーンの内部 URL の要求を受け取ると、ユーザーに返されるページのリンクには、そのゾーンのパブリック URL があります。

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

例

------------------ 例 -----------------------

#create the public URL
New-SPAlternateURL https://www.contoso.com -Zone "Internet"

#create the internal URL
New-SPAlternateURL https://sharepoint.contoso.com -Zone "Internet" -internal

この例では、 の受信要求を https://www.contoso.comhttps://sharepoint.contoso.com (インターネット ゾーン上) に変換します。

パブリック URL の SSL ターミネーションを処理するためにリバース プロキシを設定する場合は、URL 変換を処理するための代替アクセス マッピングを構成する必要があります。

パラメーター

-AssignmentCollection

-Confirm

-Internal

-ResourceName

-Url

-WebApplication

-WhatIf

-Zone