Set-UMVirtualDirectory
適用先: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
トピックの最終更新日: 2008-11-10
クライアント アクセス サーバーの役割がインストールされているコンピュータ上の既存の Exchange ユニファイド メッセージング仮想ディレクトリを変更するには、Set-UMVirtualDirectory コマンドレットを使用します。
構文
Set-UMVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
Set-UMVirtualDirectory [-BasicAuthentication <$true | $false>] [-Confirm [<SwitchParameter>]] [-DigestAuthentication <$true | $false>] [-DomainController <Fqdn>] [-ExternalUrl <Uri>] [-Instance <ADUMVirtualDirectory>] [-InternalUrl <Uri>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthentication <$true | $false>]
解説
Set-UMVirtualDirectory コマンドレットを使用すると、Exchange 2007 クライアント アクセス サーバー上の既存の Exchange Web サービス仮想ディレクトリを変更できます。
Set-UMVirtualDirectory コマンドレットを実行するには、使用するアカウントに Exchange Server Administrator の役割および対象サーバーのローカルの Administrators グループのメンバシップが委任されている必要があります。
Exchange 2007 を管理するために必要なアクセス許可、役割の委任、および権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。
パラメータ
| パラメータ | 必須かどうか | 種類 | 説明 |
|---|---|---|---|
Identity |
必須 |
Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter |
このパラメータには、仮想ディレクトリの名前を指定します。既定の Web サイトの代わりにワイルドカード文字を指定することもできます。 |
BasicAuthentication |
省略可能 |
System.Boolean |
このパラメータには、Exchange Web サービス仮想ディレクトリに対して基本認証を有効にするかどうかを指定します。このパラメータは、FormsAuthentication パラメータと共に使用することも、DigestAuthentication および WindowsAuthentication パラメータと共に使用することもできます。 |
Confirm |
省略可能 |
System.Management.Automation.SwitchParameter |
このパラメータを指定すると、コマンドの処理が一時停止します。処理を続行するには、管理者がコマンドの処理内容を確認する必要があります。既定値は |
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 認証を許可するかどうかを指定します。 |
WhatIf |
省略可能 |
System.Management.Automation.SwitchParameter |
このパラメータを指定すると、コマンドのオブジェクトに対するアクションをシミュレートできます。管理者は WhatIf パラメータを使用することで、実際に変更を加えずに、発生する変更内容を表示することができます。既定値は |
入力の種類
戻り値の種類
エラー
| エラー | 説明 |
|---|---|
|
|
例外
| 例外 | 説明 |
|---|---|
|
|
例
最初のコード例では、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 を参照してください。