Get-DomainController

Referenz

Modul:: ExchangePowerShell

Gilt für::: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Dieses Cmdlet ist nur lokal in Exchange verfügbar.

Verwenden Sie das Cmdlet Get-DomainController, um eine Liste von in Ihrer Organisation vorhandenen Domänencontrollern anzuzeigen.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

Get-DomainController
   [-GlobalCatalog]
   [-Forest <Fqdn>]
   [-Credential <NetworkCredential>]
   [<CommonParameters>]

Get-DomainController
   [-DomainName <Fqdn>]
   [-Credential <NetworkCredential>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-DomainController wird vom Exchange Admin Center verwendet, um Felder aufzufüllen, die Domänencontrollerinformationen anzeigen.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.

Beispiele

Beispiel 1

$UserCredentials = Get-Credential

Get-DomainController -DomainName corp.contoso.com -Credential $UserCredentials | Format-Table -AutoSize Name,ADSite

In diesem Beispiel wird eine Liste von globalen Katalogservern in der Domäne „corp.contoso.com“ abgerufen. Da für den Zugriff auf diese Domäne ein anderer Satz von Anmeldeinformationen erforderlich ist, wird das Cmdlet Get-Credential verwendet, um den Benutzernamen und das Kennwort vom Benutzer abzurufen.

Der erste Befehl zeigt dem Benutzer eine Eingabeaufforderung an, die den Benutzernamen und das Kennwort akzeptiert. Die Anmeldeinformationen werden dann in der Variablen $UserCredentials gespeichert. Der zweite Befehl verwendet die Variable $UserCredentials für den Credential-Parameterwert. Um die Lesbarkeit der Liste zu verbessern, wird die Ausgabe über eine Pipe an das Cmdlet Format-Table übergeben, und nur die Eigenschaften Name und ADSite werden angezeigt.

Weitere Informationen zum Pipelining und zum Cmdlet Format-Table finden Sie unter Informationen zu Pipelines und Arbeiten mit der Befehlsausgabe.

Parameter

-Credential

Der Parameter Credential gibt den Benutzernamen und das Kennwort an, die zum Ausführen dieses Befehls verwendet werden. Normalerweise verwenden Sie diesen Parameter in Skripts oder wenn Sie unterschiedliche Anmeldeinformationen bereitstellen müssen, die über die erforderlichen Berechtigungen verfügen.

Dieser Parameter erfordert die Erstellung und Übergabe eines Anmeldeinformationsobjekts. Dieses Anmeldeinformationsobjekt wird mithilfe des Cmdlets Get-Credential erstellt. Weitere Informationen finden Sie unter Get-Credential.

Wenn Sie den Gesamtstrukturparameter verwenden, werden die Anmeldeinformationen für den Zugriff auf die Gesamtstruktur verwendet.

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

Der Parameter DomainName gibt den vollqualifizierten Domänennamen (FQDN) der Domäne an, für die Sie eine Liste von Domänencontrollern zurückgeben möchten.

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

Der Parameter Forest gibt den FQDN der Stammdomäne der Gesamtstruktur an, für die Sie eine Liste von Domänencontrollern zurückgeben möchten.

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

Die Option GlobalCatalog gibt an, ob der Befehl eine Liste von globalen Katalogservern zurückgeben soll. Sie müssen bei dieser Option keinen Wert angeben.

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

Eingaben

Input types

Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.

Ausgaben

Output types

Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.