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