Get-DomainController
このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。
組織に存在するドメイン コントローラーの一覧を表示するには、Get-DomainController コマンドレットを使用します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
GlobalCatalog
Get-DomainController
[-GlobalCatalog]
[-Forest <Fqdn>]
[-Credential <NetworkCredential>]
[<CommonParameters>]
DomainController
Get-DomainController
[-DomainName <Fqdn>]
[-Credential <NetworkCredential>]
[<CommonParameters>]
説明
Get-DomainController コマンドレットは、ドメイン コントローラー情報を表示するフィールドを設定するために Exchange 管理センターによって使用されます。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
$UserCredentials = Get-Credential
Get-DomainController -DomainName corp.contoso.com -Credential $UserCredentials | Format-Table -AutoSize Name,ADSite
この例では、corp.contoso.com ドメインのグローバル カタログ サーバーの一覧を取得します。 このドメインにアクセスするには別の資格情報セットが必要であるため、Get-Credential コマンドレットを使用してユーザーからユーザー名とパスワードを取得します。
最初のコマンドは、ユーザー名とパスワードを受け入れるプロンプトをユーザーに表示します。 次いで、資格情報は $UserCredentials 変数に格納されます。 2 番目のコマンドは、Credential パラメーター値に $UserCredentials 変数を使用します。 一覧をより読みやすくするために、出力は Format-Table コマンドレットにパイプ処理され、Name プロパティと ADSite プロパティのみが表示されます。
パイプライン処理と Format-Table コマンドレットの詳細については、「 パイプライン について」と「 コマンド出力の操作」を参照してください。
パラメーター
-Credential
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Credential パラメーターは、このコマンドの実行に使用されるユーザー名とパスワードを指定します。 通常、このパラメーターはスクリプトや、必要なアクセス許可を持つ別の資格情報を入力する必要がある場合に使用します。
このパラメーターには、資格情報オブジェクトの作成および指定が必要です。 この資格情報オブジェクトは Get-Credential コマンドレットを使用して作成されます。 詳細については、Get-Credentialに関するページをご覧ください。
Forest パラメーターを使用する場合は、資格情報を使用してフォレストにアクセスします。
パラメーターのプロパティ
| 型: | NetworkCredential |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainName
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
DomainName パラメーターには、ドメイン コントローラーの一覧を返すドメインの完全修飾ドメイン名 (FQDN) を指定します。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
DomainController
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Forest
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Forest パラメーターには、ドメイン コントローラーの一覧を返すフォレストのルート ドメインの FQDN を指定します。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
GlobalCatalog
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-GlobalCatalog
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
GlobalCatalog スイッチには、コマンドがグローバル カタログ サーバーの一覧を返す必要があるかどうかを指定します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
GlobalCatalog
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。