Get-ExchangeServer
このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。
Get-ExchangeServer コマンドレットを使用して、Exchange サーバーのプロパティを表示します。
パラメーターなしで Get-ExchangeServer コマンドレットを実行すると、Exchange organization内のすべてのサーバーの属性が返されます。 Get-ExchangeServer コマンドレットがサーバーに直接接続するか、複雑または低速の計算を実行する必要がある特定のサーバー プロパティ (ドメイン コントローラー情報を含む) を返すには、Status パラメーターを使用してください。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Domain
Get-ExchangeServer
-Domain <Fqdn>
[-DomainController <Fqdn>]
[-Status]
[<CommonParameters>]
Identity
Get-ExchangeServer
[[-Identity] <ServerIdParameter>]
[-DomainController <Fqdn>]
[-Status]
[<CommonParameters>]
説明
返される ExchangeVersion 属性は、返されるオブジェクトの管理に使用できる Microsoft Exchange の最小バージョンです。 この属性は、[サーバー構成] を選択したときに Exchange 管理センターに表示される Exchange のバージョンと同じではありません。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Get-ExchangeServer | Format-List
次の使用例は、organization内のすべての Exchange サーバーの概要リストを返します。
例 2
Get-ExchangeServer -Identity Mailbox01 | Format-List
次の使用例は、Mailbox01 という名前の Exchange サーバーに関する詳細情報を返します。
パラメーター
-Domain
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Domain パラメーターは、ドメインの完全修飾ドメイン名 (FQDN) によって結果をフィルター処理します (たとえば、contoso.com)。
データベース名
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Domain
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
DomainController パラメーターは、エッジ トランスポート サーバーではサポートされません。 エッジ トランスポート サーバーは、Active Directory ライトウェイト ディレクトリ サービス (AD LDS) のローカル インスタンスを使用してデータの読み書きを行います。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Identity パラメーターは、表示する Exchange サーバーを指定します。 Exchange サーバーを一意に識別する任意の値を使用できます。 例:
- Name
- GUID
- 識別名 (DN)
- ExchangeLegacyDN
Domain パラメーターでは、このパラメーターを使用できません。
注意: Identity パラメーターの値$null値または存在しない値は、Identity パラメーターなしで Get- コマンドを実行したかのように 、すべての オブジェクトを返します。 Identity パラメーターの値の一覧が正確であり、存在しない$null値が含まれていないことを確認します。
パラメーターのプロパティ
| 型: | ServerIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Identity
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Status
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
状態スイッチは、結果に追加のプロパティ値を含めるかどうかを指定します (たとえば、Watson 状態、StaticDomainControllers、ランタイム ドメイン コントローラーの使用状況など)。 このスイッチで値を指定する必要はありません。
追加の値を参照するには、Format-List コマンドレットなどの書式設定コマンドレットに出力をパイプ処理する必要があります。
パラメーターのプロパティ
| 型: | 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
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。