次の方法で共有


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 という名の新しい仮想ディレクトリを作成できます。このコマンドレットでは、複数の仮想ディレクトリを作成できます。

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 を参照してください。