Get-EcpVirtualDirectory

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。

Get-EcpVirtualDirectory コマンドレットを使用して、Microsoft Exchange サーバー上のインターネットインフォメーションサービス (IIS) で使用されている Exchange コントロールパネル (ECP) 仮想ディレクトリを表示します。 Exchange 管理センター (EAC) では、ECP 仮想ディレクトリが使用されます。

ECP Web 管理インターフェイスは、Exchange Server 2010 で導入されました。 Exchange Server 2013 および Exchange Server 2016 では、EAC 仮想ディレクトリと対応する管理コマンドレットは、名前に ECP を引き続き使用します。これらのコマンドレットを使用して、Exchange 2010、Exchange 2013、および Exchange 2016 サーバー上の ECP 仮想ディレクトリを管理できます。

以下の構文セクションのパラメーターセットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Get-EcpVirtualDirectory
   -Server <ServerIdParameter>
   [-ADPropertiesOnly]
   [-DomainController <Fqdn>]
   [-ShowMailboxVirtualDirectories]
   [<CommonParameters>]

Get-EcpVirtualDirectory
   [[-Identity] <VirtualDirectoryIdParameter>]
   [-ADPropertiesOnly]
   [-DomainController <Fqdn>]
   [-ShowMailboxVirtualDirectories]
   [<CommonParameters>]

説明

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

Get-EcpVirtualDirectory -Server Server01

次の使用例は、Server01 という名前のサーバー上のすべての Exchange コントロールパネル仮想ディレクトリの概要リストを返します。

例 2

Get-EcpVirtualDirectory -Identity "Server01\ecp*" | Format-List

次の使用例は、Server01 という名前のサーバー上の "ecp (既定の Web サイト)" という名前の Exchange コントロールパネル仮想ディレクトリの詳細情報を返します。

例 3

Get-EcpVirtualDirectory

次の使用例は、組織内のすべてのメールボックスサーバー上のクライアントアクセスサービス内のすべての Exchange コントロールパネル仮想ディレクトリの概要リストを返します。

パラメーター

-ADPropertiesOnly

ADPropertiesOnly スイッチは、Active Directory に格納されている仮想ディレクトリプロパティのみを返すかどうかを指定します。このスイッチで値を指定する必要はありません。

このスイッチを使用しない場合は、Active Directory とインターネットインフォメーションサービス (IIS) メタベースのプロパティが返されます。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメインコントローラーを指定します。ドメインコントローラーは、完全修飾ドメイン名 (FQDN) で識別します。たとえば、dc01.contoso.com です。

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Identity パラメーターは、表示する ECP 仮想ディレクトリを指定します。仮想ディレクトリを一意に識別する任意の値を使用できます。例:

名前またはサーバー\Name
識別名 (DN)
GUID

Name 値は、仮想ディレクトリのプロパティの構文 "VirtualDirectoryName (WebsiteName)" を使用します。構文 VirtualDirectoryName*を使用して、既定の Web サイトの代わりにワイルドカード文字 (*) を指定できます。

同じコマンドで、Identity と Server の両方のパラメーターを使用することはできません。

Type:	VirtualDirectoryIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Server

Server パラメーターは、仮想ディレクトリをホストする Exchange サーバーを指定します。サーバーを一意に識別する任意の値を使用できます。次に例を示します。

名前
FQDN
識別名 (DN)
ExchangeLegacyDN

同じコマンドで、Server と Identity の両方のパラメーターを使用することはできません。

Type:	ServerIdParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ShowMailboxVirtualDirectories

ShowMailboxVirtualDirectories スイッチは、メールボックスサーバー上のバックエンド仮想ディレクトリに関する情報を表示します。このスイッチで値を指定する必要はありません。

既定では、このコマンドレットはメールボックスサーバー上のクライアントアクセスサービス内の仮想ディレクトリに関する情報を表示します。クライアント接続は、メールボックスサーバー上のクライアントアクセスサービスからメールボックスサーバー上のバックエンドサービスにプロキシされます。クライアントは、バックエンドサービスに直接接続しません。

既定では、このコマンドレットは、メールボックスサーバー上のクライアントアクセスサービスの仮想ディレクトリに関する情報を示します。クライアント接続は、メールボックスサーバー上のクライアントアクセスサービスから、メールボックスサーバー上のバックエンドサービスにプロキシされます。クライアントは、バックエンドサービスに直接接続しません。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

入力

Input types

このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。

出力

Output types

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。