Get-DomainController
このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。
組織に存在するドメイン コントローラーの一覧を表示するには、Get-DomainController コマンドレットを使用します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Get-DomainController
[-GlobalCatalog]
[-Forest <Fqdn>]
[-Credential <NetworkCredential>]
[<CommonParameters>]
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
Credential パラメーターは、このコマンドの実行に使用されるユーザー名とパスワードを指定します。 通常、このパラメーターはスクリプトや、必要なアクセス許可を持つ別の資格情報を入力する必要がある場合に使用します。
このパラメーターには、資格情報オブジェクトの作成および指定が必要です。 この資格情報オブジェクトは Get-Credential コマンドレットを使用して作成されます。 詳細については、Get-Credentialに関するページをご覧ください。
Forest パラメーターを使用する場合は、資格情報を使用してフォレストにアクセスします。
Type: | NetworkCredential |
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 |
-DomainName
DomainName パラメーターには、ドメイン コントローラーの一覧を返すドメインの完全修飾ドメイン名 (FQDN) を指定します。
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 |
-Forest
Forest パラメーターには、ドメイン コントローラーの一覧を返すフォレストのルート ドメインの FQDN を指定します。
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 |
-GlobalCatalog
GlobalCatalog スイッチには、コマンドがグローバル カタログ サーバーの一覧を返す必要があるかどうかを指定します。 このスイッチで値を指定する必要はありません。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。