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