Get-MapiVirtualDirectory
このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。
Get-MapiVirtualDirectory コマンドレットを使用して、Microsoft Exchange サーバー上のインターネット インフォメーション サービス (IIS) で使用されているメッセージ アプリケーション プログラミング インターフェイス (MAPI) 仮想ディレクトリを表示します。 MAPI 仮想ディレクトリは、サポートされているバージョンの Microsoft Outlook で MAPIHTTP プロトコルを使用してメールボックスに接続するために使用されます。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Server
Get-MapiVirtualDirectory
-Server <ServerIdParameter>
[-ADPropertiesOnly]
[-DomainController <Fqdn>]
[-ShowMailboxVirtualDirectories]
[<CommonParameters>]
Identity
Get-MapiVirtualDirectory
[[-Identity] <VirtualDirectoryIdParameter>]
[-ADPropertiesOnly]
[-DomainController <Fqdn>]
[-ShowMailboxVirtualDirectories]
[<CommonParameters>]
説明
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事にはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Get-MapiVirtualDirectory -Server ContosoMail
この例では、ContosoMail という名前のサーバー上の MAPI 仮想ディレクトリの要約リストを返します。
例 2
Get-MapiVirtualDirectory -Identity "ContosoMail\mapi (Default Web Site)" | Format-List
Get-MapiVirtualDirectory "ContosoMail\mapi (Default Web Site)" | Format-List
Get-MapiVirtualDirectory ContosoMai\mapi* | Format-List
これらの例では、ContosoMail という名前のサーバー上の "mapi (既定の Web サイト)" という名前の MAPI 仮想ディレクトリの詳細情報を返します。 3 つのコマンドの処理内容はすべて同じでます。
例 3
Get-MapiVirtualDirectory
この例では、組織内のすべてのメールボックス サーバー上のクライアント アクセス サービスにある、すべての MAPI 仮想ディレクトリの要約リストを返します。
パラメーター
-ADPropertiesOnly
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ADPropertiesOnly スイッチは、Active Directory に格納されている仮想ディレクトリ プロパティのみを返すかどうかを指定します。 このスイッチで値を指定する必要はありません。
このスイッチを使用しない場合は、Active Directory とインターネット インフォメーション サービス (IIS) メタベースのプロパティが返されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Identity パラメーターは、表示する MAPI 仮想ディレクトリを指定します。 仮想ディレクトリを一意に識別する任意の値を使用できます。 例:
- 名前またはサーバー\Name
- 識別名 (DN)
- GUID
Name 値は、仮想ディレクトリのプロパティから "VirtualDirectoryName (WebsiteName)" 構文を使用します。 構文 VirtualDirectoryName*を使用して、既定の Web サイトではなくワイルドカード文字 (*) を指定できます。
同じコマンドで、Identity と Server の両方のパラメーターを使用することはできません。
注意: Identity パラメーターの値$null値または存在しない値は、Identity パラメーターなしで Get- コマンドを実行したかのように 、すべての オブジェクトを返します。 Identity パラメーターの値の一覧が正確であり、存在しない$null値が含まれていないことを確認します。
パラメーターのプロパティ
| 型: | VirtualDirectoryIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identity
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Server
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Server パラメーターは、仮想ディレクトリをホストする Exchange サーバーを指定します。 サーバーを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- FQDN
- 識別名 (DN)
- ExchangeLegacyDN
同じコマンドで、Server と Identity の両方のパラメーターを使用することはできません。
パラメーターのプロパティ
| 型: | ServerIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Server
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ShowMailboxVirtualDirectories
適用対象: Exchange Server 2013
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
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。