Freigeben über

Get-DomainController

Modul:
Exchange PowerShell

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

GlobalCatalog 

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

DomainController 

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. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen 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

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Parametereigenschaften

Typ:NetworkCredential
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DomainName

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Parametereigenschaften

Typ:Fqdn
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

DomainController
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Forest

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Parametereigenschaften

Typ:Fqdn
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

GlobalCatalog
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-GlobalCatalog

Anwendbar: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

GlobalCatalog
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.

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 und die von diesem Cmdlet akzeptiert werden, finden Sie unter Eingabe- und Ausgabetypen von Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.