Get-WebServicesVirtualDirectory
このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。
Get-WebServicesVirtualDirectory コマンドレットを使用して、Microsoft Exchange サーバー上のインターネット インフォメーション サービス (IIS) で使用されている Exchange Web Services (EWS) 仮想ディレクトリを表示します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Server
Get-WebServicesVirtualDirectory
-Server <ServerIdParameter>
[-ADPropertiesOnly]
[-DomainController <Fqdn>]
[-ShowMailboxVirtualDirectories]
[<CommonParameters>]
Identity
Get-WebServicesVirtualDirectory
[[-Identity] <VirtualDirectoryIdParameter>]
[-ADPropertiesOnly]
[-DomainController <Fqdn>]
[-ShowMailboxVirtualDirectories]
[<CommonParameters>]
説明
Get-WebServicesVirtualDirectory コマンドレットは、ローカル コンピューター上で実行できます。あるいは、Identity パラメーターまたは Server パラメーターにサーバー名を指定すれば、このコマンドレットをリモートで実行できます。
Get-WebServicesVirtualDirectory コマンドレットは、Exchange 管理ツールがインストールされている任意のサーバーで実行できます。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Get-WebServicesVirtualDirectory -Server MBX01
この例では、MBX01 というサーバー上のすべての EWS 仮想ディレクトリの要約リストを返します。
例 2
Get-WebServicesVirtualDirectory -Identity "MBX01\EWS*" | Format-List
この例では、MBX01 というサーバー上の「EWS (Default Web Site)」という名前の EWS 仮想ディレクトリの詳細情報を返します。
例 3
Get-WebServicesVirtualDirectory
次の使用例は、organization内のすべてのメールボックス サーバー上のクライアント アクセス サービス内のすべての仮想ディレクトリの概要リストを返します。
パラメーター
-ADPropertiesOnly
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
ADPropertiesOnly スイッチは、Active Directory に格納されている仮想ディレクトリ プロパティのみを返すかどうかを指定します。 このスイッチで値を指定する必要はありません。
このスイッチを使用しない場合は、Active Directory とインターネット インフォメーション サービス (IIS) メタベースのプロパティが返されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Identity パラメーターは、表示する EWS 仮想ディレクトリを指定します。 仮想ディレクトリを一意に識別する任意の値を使用できます。 例:
- 名前またはサーバー\Name
- 識別名 (DN)
- GUID
Name 値は、仮想ディレクトリのプロパティから "VirtualDirectoryName (WebsiteName)" 構文を使用します。 構文 VirtualDirectoryName*を使用して、既定の Web サイトではなくワイルドカード文字 (*) を指定できます。
同じコマンドで、Identity と Server の両方のパラメーターを使用することはできません。
パラメーターのプロパティ
| 型: | VirtualDirectoryIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identity
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Server
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Server パラメーターは、仮想ディレクトリをホストする Exchange サーバーを指定します。 サーバーを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- FQDN
- 識別名 (DN)
- ExchangeLegacyDN
同じコマンドで、Server と Identity の両方のパラメーターを使用することはできません。
パラメーターのプロパティ
| 型: | ServerIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Server
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ShowMailboxVirtualDirectories
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
ShowMailboxVirtualDirectories スイッチは、メールボックス サーバー上のバックエンド仮想ディレクトリに関する情報を表示します。 このスイッチで値を指定する必要はありません。
既定では、このコマンドレットはメールボックス サーバー上のクライアント アクセス サービス内の仮想ディレクトリに関する情報を表示します。 クライアント接続は、メールボックス サーバー上のクライアント アクセス サービスからメールボックス サーバー上のバックエンド サービスにプロキシされます。 クライアントは、バックエンド サービスに直接接続しません。
既定では、このコマンドレットは、メールボックス サーバー上のクライアント アクセス サービスの仮想ディレクトリに関する情報を示します。クライアント接続は、メールボックス サーバー上のクライアント アクセス サービスから、メールボックス サーバー上のバックエンド サービスにプロキシされます。クライアントは、バックエンド サービスに直接接続しません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。