Set-WebServicesVirtualDirectory (RTM)
適用先: Exchange Server 2007
トピックの最終更新日: 2007-06-11
Set-WebServicesVirtualDirectory コマンドレットを使用すると、クライアント アクセス サーバーの役割がインストールされている Exchange 2007 コンピュータ上の既存の Exchange Web サービス仮想ディレクトリを変更できます。
構文
Set-WebServicesVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-BasicAuthentication <$true | $false>] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Url>] [-InternalUrl <Url>] [-WindowsAuthentication <$true | $false>]
解説
Set-WebServicesVirtualDirectory コマンドレットを使用すると、Exchange 2007 クライアント アクセス サーバー上の既存の Exchange Web サービス仮想ディレクトリを変更できます。
注 : |
---|
負荷分散された一連のクライアント アクセス サーバーを使用している場合は、このコマンドレットの実行時に各サーバーの名前を指定する必要はありません。負荷分散されたネットワーク サーバーのうちの、いずれかのサーバーの名前を指定するだけで十分です。 |
Set-WebServicesVirtualDirectory コマンドレットを実行するには、使用するアカウントに次の権限が委任されている必要があります。
- Exchange サーバー管理者の役割および対象サーバーのローカル Administrators グループ
アクセス許可、役割の委任、および Microsoft Exchange Server 2007 を管理するために必要な権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。
パラメータ
パラメータ | 必須 | 種類 | 説明 |
---|---|---|---|
Identity |
必須 |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter |
このパラメータには、仮想ディレクトリの名前を指定します。既定の Web サイトの代わりにワイルドカード文字を指定することもできます。 |
BasicAuthentication |
省略可能 |
System.Boolean |
このパラメータには、Exchange Web サービス仮想ディレクトリに対して基本認証を有効にするかどうかを指定します。このパラメータは、FormsAuthentication と共に使用することも、DigestAuthentication および WindowsAuthentication と共に使用することもできます。 |
DigestAuthentication |
省略可能 |
System.Boolean |
このパラメータには、仮想ディレクトリに対してダイジェスト認証を有効にするかどうかを指定します。 |
DomainController |
省略可能 |
System.String |
Active Directory ディレクトリ サービスからデータを取得するドメイン コントローラの完全修飾ドメイン名 (FQDN) を指定するには、コマンドレットに DomainController パラメータを含めます。 |
ExternalUrl |
省略可能 |
System.Uri |
このパラメータには、ファイアウォールの外側から Exchange サーバーに接続する際に使用されるホスト名を指定します。この設定は、SSL (Secure Sockets Layer) を使用する場合にも重要です。 |
Instance |
省略可能 |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ADWebServicesVirtualDirectory |
Instance パラメータを使用すると、オブジェクト全体をコマンドレットに渡して処理することができます。 |
InternalUrl |
省略可能 |
System.Uri |
このパラメータには、ファイアウォールの内部から接続する Exchange サーバーのホスト名を指定します。この設定は、SSL を使用する場合にも重要です。 |
WindowsAuthentication |
省略可能 |
System.Boolean |
このパラメータには、Exchange Web サービス仮想ディレクトリに対して統合 Windows 認証を許可するかどうかを指定します。 |
入力の種類
戻り値の種類
エラー
エラー | 説明 |
---|---|
|
|
例外
例外 | 説明 |
---|---|
|
|
例
次のコード例は、"Contoso" という名前のサーバー上にある "EWS" という名前の仮想ディレクトリに対する認証の方法を基本認証に設定します。また、このコード例では、この仮想ディレクトリに対して外部 URL と内部 URL を設定しています。
2 番目のコード例では、"既定の Web サイト" の代わりにワイルドカード文字を使用しています。
Set-WebServicesVirtualDirectory -Identity Contoso\EWS(default web site)-ExternalUrl https://www.contoso.com/EWS/exchange.aspx -ExternalAuthenticationMethods Basic -InternalUrl https://contoso.internal.com/EWS/webservices.aspx
Set-WebServicesVirtualDirectory -Identity Contoso\EWS* -ExternalUrl https://www.contoso.com/ews/exchange.aspx
参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。