New-WebServicesVirtualDirectory
適用先: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
トピックの最終更新日: 2007-08-20
New-WebServicesVirtualDirectory コマンドレットを使用すると、クライアント アクセス サーバーの役割がインストールされた Microsoft Exchange Server 2007 を実行しているコンピュータで、EWS という名の新しい仮想ディレクトリを作成できます。
構文
New-WebServicesVirtualDirectory [-ApplicationRoot <String>] [-AppPoolId <String>] [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalNLBBypassUrl <Uri>] [-InternalUrl <Uri>] [-Path <String>] [-TemplateInstance <PSObject>] [-WebSiteName <String>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
解説
New-WebServicesVirtualDirectory コマンドレットを使用すると、Exchange 2007 クライアント アクセス サーバーで EWS という名の新しい仮想ディレクトリを作成できます。このコマンドレットでは、複数の仮想ディレクトリを作成できます。
.gif "note") 注 : |
|---|
| EWS 仮想ディレクトリを作成できるのは各 Web サイトにつき 1 つのみです。 |
New-WebServicesVirtualDirectory コマンドレットを実行するには、使用するアカウントに Exchange Server Administrator の役割および対象サーバーのローカルの Administrators グループのメンバシップが委任されている必要があります。
アクセス許可、役割の委任、および Exchange 2007 を管理するために必要な権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。
パラメータ
| パラメータ | 必須かどうか | 種類 | 説明 |
|---|---|---|---|
ApplicationRoot |
省略可能 |
System.String |
このパラメータには、仮想ディレクトリのメタベース パスを設定します。既定では、このパスは仮想ディレクトリが作成された Web サイトと同じです。 |
AppPoolId |
省略可能 |
System.String |
このパラメータには、仮想ディレクトリで使用できるプログラム プールを設定します。 |
BasicAuthentication |
省略可能 |
System.Boolean |
このパラメータには、EWS 仮想ディレクトリに対して基本認証を有効にするかどうかを指定します。 |
Confirm |
省略可能 |
System.Management.Automation.SwitchParameter |
Confirm パラメータを指定すると、コマンドの処理が一時停止します。処理を続行するには、コマンドの処理内容を確認する必要があります。Confirm パラメータで値を指定する必要はありません。 |
DigestAuthentication |
省略可能 |
System.Boolean |
このパラメータには、仮想ディレクトリでダイジェスト認証を使用するかどうかを指定します。 |
DomainController |
省略可能 |
Microsoft.Exchange.Data.Fqdn |
この構成の変更を Active Directory ディレクトリ サービスに書き込むドメイン コントローラの完全修飾ドメイン名 (FQDN) を指定するには、コマンドレットに DomainController パラメータを含めます。 |
ExternalUrl |
省略可能 |
System.Uri |
このパラメータには、境界ネットワークの外側から Exchange サーバーに接続する際に使用するホスト名を指定します。 |
InternalNLBBypassUrl |
省略可能 |
System.Uri |
このパラメータには、クライアント アクセス サーバーの URL を指定します。その URL がネットワーク負荷分散 (NLB) 配列の背後にあるかどうかは関係ありません。InternalUrl パラメータは NLB の URL に設定されますが、InternalNLBBypassUrl パラメータは、常にクライアント アクセス サーバーの URL に設定します。これは、Exchange Web サービスでは一部の呼び出しがマシンの類似性を要求し、可能な場合はいつでも、着信呼び出しを、より適切なクライアント アクセス サーバーに委任するからです。 |
InternalUrl |
省略可能 |
System.Uri |
このパラメータには、ネットワークのファイアウォールの内側から仮想ディレクトリへの接続に使用される URL を指定します。 |
Path |
省略可能 |
System.String |
このパラメータは、メタベース内で仮想ディレクトリのパスを設定します。 |
TemplateInstance |
省略可能 |
System.Management.Automation.PSObject |
このパラメータに既存のオブジェクトを指定すると、コマンドはそのオブジェクトの構成を使用してローカル サーバーまたはターゲット サーバーにオブジェクトのコピーを作成します。 |
WebSiteName |
省略可能 |
System.String |
このパラメータには、新しい仮想ディレクトリを作成する Web サイトの名前を指定します。このパラメータは、既定の Web サイトの下に新しい仮想ディレクトリを作成する場合には使用しないでください。 |
WindowsAuthentication |
省略可能 |
System.Boolean |
このパラメータには、新しい Exchange Web サービス仮想ディレクトリに対して統合 Windows 認証を許可するかどうかを指定します。 |
WhatIf |
省略可能 |
System.Management.Automation.SwitchParameter |
WhatIf パラメータには、オブジェクトに対して行われる操作をシミュレートすることを指定します。WhatIf パラメータを使用することで、実際に変更を加えずに、発生する変更内容を表示することができます。WhatIf パラメータで値を指定する必要はありません。 |
入力の種類
戻り値の種類
エラー
| エラー | 説明 |
|---|---|
|
|
例外
| 例外 | 説明 |
|---|---|
|
|
例
次のコード例は、外部 URL が "https://www.contoso.com/webservices.aspx" に設定された、"contoso" という名前の新しい仮想ディレクトリを作成します。
New-WebServicesVirtualDirectory -WebsiteName "www.contoso.com" -ExternalUrl "https://www.contoso.com/webservices.aspx"
参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。