Set-CsWebServer
トピックの最終更新日: 2012-03-25
Lync Server で使用する 1 つ以上の Web サーバー サービスを変更します。UNRESOLVED_TOKEN_VAL(ps-intro-in-LS2010)
構文
Set-CsWebServer [-Identity <XdsGlobalRelativeIdentity>] [-AppSharingPortCount <UInt16>] [-AppSharingPortStart <UInt16>] [-Confirm [<SwitchParameter>]] [-ExternalFqdn <Fqdn>] [-ExternalHttpPort <UInt16>] [-ExternalHttpsPort <UInt16>] [-Force <SwitchParameter>] [-InternalFqdn <Fqdn>] [-McxSipExternalListeningPort <UInt16>] [-McxSipPrimaryListeningPort <UInt16>] [-MeetingRoomAdminPortalExternalListeningPort <UInt16>] [-MeetingRoomAdminPortalInternalListeningPort <UInt16>] [-PrimaryHttpPort <UInt16>] [-PrimaryHttpsPort <UInt16>] [-PublishedExternalHttpPort <UInt16>] [-PublishedExternalHttpsPort <UInt16>] [-PublishedPrimaryHttpPort <UInt16>] [-PublishedPrimaryHttpsPort <UInt16>] [-ReachExternalPsomServerPort <UInt16>] [-ReachPrimaryPsomServerPort <UInt16>] [-RmWebSipExternalListeningPort <UInt16>] [-RmWebSipPrimaryListeningPort <UInt16>] [-SupportConferenceConsoleSipExternalListeningPort <UInt16>] [-SupportConferenceConsoleSipPrimaryListeningPort <UInt16>] [-UcapSipPrimaryListeningPort <UInt16>] [-UcwaSipExternalListeningPort <UInt16>] [-UcwaSipPrimaryListeningPort <UInt16>] [-UserServer <String>] [-VxmlSipPrimaryListeningPort <UInt16>] [-WhatIf [<SwitchParameter>]]
例
例 1
例 1 に示すコマンドは、次の 1 つの Web サービス プールの PrimaryHttpPort を変更します。ID が WebServer:atl-cs-001.litwareinc.com のプールです。この例では、ポートはポート番号 89 に変更されます。
Set-CsWebServer -Identity "WebServer:atl-cs-001.litwareinc.com" -PrimaryHttpPort 89
例 2
例 2 に示すコマンドは、例 1 で示したコマンドの変化形です。この例では、組織内のすべての Web サービス プールの PrimaryHttpPort を変更します。これを行うため、まず Get-CsService コマンドレットと WebServer パラメーターを使用して、現在使用されているすべての Web サービス プールのコレクションを戻します。次に、このコレクションを ForEach-Object コマンドレットへパイプ処理し、コレクション内の各プールを取得して、PrimaryHttpPort をポート 89 に設定しています。Set-CsWebServer コマンドレットはパイプ処理データそのものを受け入れることができないため、データは ForEach-Object コマンドレットへパイプ処理する必要があります。
Get-CsService -WebServer | ForEach-Object {Set-CsWebServer -Identity $_.Identity -PrimaryHttpPort 89}
解説
Lync Server では、Web サーバーおよび Web サービスを幅広く利用します。たとえば、アドレス帳のクエリは、Web サービス (アドレス帳クエリ Web サービス) を使用して処理できます。また、Lync Server は、ユーザーがダイヤルイン会議の暗証番号 (PIN) の構成などを行うための Web ページをホストします。Web サーバーおよび Web サービスが果たす重要な役割を考えると、管理者がこれらのサーバーおよびサービスがどのように構成されているかを把握しておくことは重要です。その情報は、次のコマンドによって戻すことができます。
Get-CsService -WebServer
また、管理者が Web サーバーの構成方法を変更できることが重要となる場合もあります。たとえば、外部 HTTP 接続または HTTPS 接続に使用するポートの変更が必要な場合があります。このようなポートの変更 (およびその他の変更) は、Set-CsWebServer コマンドレットを使用して行うことができます。
このコマンドレットを実行できるユーザー: 既定では、Set-CsWebServer コマンドレットをローカルで実行する権限があるのは、RTCUniversalServerAdmins グループのメンバーです。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Set-CsWebServer"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
AppSharingPortCount |
省略可能 |
System.UInt16 |
アプリケーション共有に割り当てられたポートの合計数です。開かれる実際のポートは AppSharingPortStart に指定された値から始まり、AppSharingPortCount に指定されたポート数まで続きます。たとえば、AppSharingPortStart を 60000 に、AppSharingPortCount を 100 に設定すると、ポート 60000 から 60099 までがアプリケーション共有に使用されます。既定値は 16383 です。 |
AppSharingPortStart |
省略可能 |
System.UInt16 |
アプリケーション共有に割り当てられるポートの範囲内の最初のポートです。既定値は 49152 です。 |
Confirm |
省略可能 |
System.Management.Automation.SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
ExternalFqdn |
省略可能 |
Microsoft.Rtc.Management.Deploy.Fqdn |
内部ネットワークの外から Web サービス プールへ接続するユーザーが使用する、完全修飾ドメイン名 (FQDN) です。次に例を示します。-ExternalFqdn "www.litwareinc.com"。 |
ExternalHttpPort |
省略可能 |
System.UInt16 |
HTTP プロトコルによる外部 Web 接続用のポート番号です。既定値はポート 8080 です。 |
ExternalHttpsPort |
省略可能 |
System.UInt16 |
HTTPS プロトコルによる外部 Web 接続用のポート番号です。既定値はポート 4443 です。 |
Force |
省略可能 |
System.Management.Automation.SwitchParameter |
コマンド実行中に発生する可能性のある、致命的ではないすべてのエラー メッセージを表示しないようにします。 |
Identity |
省略可能 |
Microsoft.Rtc.Management.Xds.XdsGlobalRelativeIdentity |
Web サービス プールの一意の識別子です。次に例を示します。-Identity "WebServer:atl-cs-001.litwareinc.com" なお、Web サーバーを指定する場合、プレフィックス "WebServer:" は省略できます。次に例を示します。-Identity "atl-cs-001.litwareinc.com"。 |
InternalFqdn |
省略可能 |
Microsoft.Rtc.Management.Deploy.Fqdn |
Mobility Service の完全修飾ドメイン名。InternalFqdn には、組織のファイアウォール内からのみアクセスできる必要があります。 |
McxSipExternalListeningPort |
省略可能 |
System.UInt16 |
Mobility Service の外部リッスン ポート。 |
McxSipPrimaryListeningPort |
省略可能 |
System.UInt16 |
Mobility Service の内部リッスン ポート。 |
MeetingRoomAdminPortalExternalListeningPort |
省略可能 |
System.UInt16 |
Lync 会議室管理ポータルの外部リッスン ポートです。管理ポータルは、管理者が会議室を簡単に管理できるようにする Web ベースのユーティリティです。 |
MeetingRoomAdminPortalInternalListeningPort |
省略可能 |
System.UInt16 |
Lync 会議室管理ポータルの内部リッスン ポートです。管理ポータルは、管理者が会議室を簡単に管理できるようにする Web ベースのユーティリティです。 |
PrimaryHttpPort |
省略可能 |
System.UInt16 |
HTTP プロトコルによる内部 Web 接続用のポート番号です。既定値はポート 80 です。 |
PrimaryHttpsPort |
省略可能 |
System.UInt16 |
HTTPS プロトコルによる内部 Web 接続用のポート番号です。既定値はポート 443 です。 |
PublishedExternalHttpPort |
省略可能 |
System.UInt16 |
公開された外部 HTTP ポートのポート番号。 |
PublishedExternalHttpsPort |
省略可能 |
System.UInt16 |
Mobility Service の外部ポート。 |
PublishedPrimaryHttpPort |
省略可能 |
System.UInt16 |
公開されたプライマリ HTTP ポートのポート番号。 |
PublishedPrimaryHttpsPort |
省略可能 |
System.UInt16 |
Mobility Service の内部ポート。 |
ReachExternalPsomServerPort |
省略可能 |
System.UInt16 |
永続共有オブジェクト モデル プロトコル用の外部ポート番号です。永続共有オブジェクト モデル プロトコルは、Microsoft の会議用プロトコルです。既定のポート番号は 8061 です。 |
ReachPrimaryPsomServerPort |
省略可能 |
System.UInt16 |
永続共有オブジェクト モデル (PSOM) プロトコル用のプライマリ ポート番号です。PSOM プロトコルは、Microsoft の会議用プロトコルです。既定のポート番号は 8060 です。 |
RmWebSipExternalListeningPort |
省略可能 |
System.UInt16 |
常設チャット ルームの管理 Web App の外部リッスン ポート。このアプリケーションは、常設チャットをインストールして設定した場合に限り使用できます。 |
RmWebSipPrimaryListeningPort |
省略可能 |
System.UInt16 |
常設チャット ルームの管理 Web App のプライマリ リッスン ポート。このアプリケーションは、常設チャットをインストールして設定した場合に限り使用できます。 |
SupportConferenceConsoleSipExternalListeningPort |
省略可能 |
System.UInt16 |
サポート会議コンソールのリッスンポート。既定値は 6007 です。 |
SupportConferenceConsoleSipPrimaryListeningPort |
省略可能 |
System.UInt16 |
Office 365 サポート会議コンソールが使用するポート。このコンソールは、サポート担当者が電話会議やオンライン会議の問題のトラブルシューティングに使用します。 |
UcapSipPrimaryListeningPort |
省略可能 |
System.UInt16 |
統合コミュニケーション アプリケーション プラットフォーム (Ucap) のリッスン ポート。Ucap は、統合コミュニケーション サービスを複数テナント環境に展開する方法を提供します。 |
UcwaSipExternalListeningPort |
省略可能 |
System.UInt16 |
統合コミュニケーション Web API (UCWA) の外部 SIP リッスン ポート。既定値は 5088 です。 |
UcwaSipPrimaryListeningPort |
省略可能 |
System.UInt16 |
統合コミュニケーション Web API (UCWA) の内部 SIP リッスン ポート。既定値は 5089 です。 |
UserServer |
省略可能 |
System.String |
Web サービス プールに関連するユーザー サービス プールのサービス ID です。次に例を示します。-UserServer "UserServer:atl-cs-001.litwareinc.com" |
VxmlSipPrimaryListeningPort |
省略可能 |
System.UInt16 |
VoiceXML (VXML) のリッスン ポート。VXML は、人間とソフトウェア アプリケーションの間の対話を指定するためのインターネット標準です。たとえば、電話の着信に自動的に応答したり、再ルーティングするアプリケーションで VXML を使用している場合があります。 |
WhatIf |
省略可能 |
System.Management.Automation.SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
入力の種類
なし。Set-CsWebServer コマンドレットは、パイプ処理による入力を受け入れません。
戻り値の種類
なし。代わりに、Set-CsWebServer コマンドレットは、Microsoft.Rtc.Management.Xds.DisplayWebServer オブジェクトのインスタンスを変更します。