Freigeben über

Get-CMActiveDirectoryForest

  • Referenz
Modul:
ConfigurationManager

Ruft mindestens ein Active Directory-Gesamtstrukturobjekt ab.

Syntax

Get-CMActiveDirectoryForest
   [-ForestFqdn <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMActiveDirectoryForest
   -Id <String[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-CMActiveDirectoryForest ruft mindestens ein Active Directory-Gesamtstrukturobjekt in Configuration Manager ab. Sie können ein Active Directory-Gesamtstrukturobjekt nach ID oder vollqualifiziertem Domänennamen (FQDN) abrufen.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Abrufen aller Active Directory-Gesamtstrukturobjekte

PS XYZ:\> Get-CMActiveDirectoryForest

Dieser Befehl ruft alle Active Directory-Gesamtstrukturobjekte ab.

Beispiel 2: Abrufen eines Active Directory-Gesamtstrukturobjekts nach ID

PS XYZ:\> Get-CMActiveDirectoryForest -Id "16777217"

Dieser Befehl ruft ein Active Directory-Gesamtstrukturobjekt ab, das die ID 16777217 hat.

Beispiel 3: Abrufen der Active Directory-Gesamtstruktur nach Domänenname

PS XYZ:\> Get-CMActiveDirectoryForest -ForestFqdn "tsqa.contoso.com"

Dieser Befehl ruft ein Active Directory-Gesamtstrukturobjekt ab, das über den FQDN tsqa.contoso.com verfügt.

Parameter

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForestFqdn

Gibt den FQDN eines Configuration Manager-Objekts an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-Id

Gibt ein Array von IDs von Configuration Manager-Objekten an. Sie finden den Bezeichnerwert in der ForestID-Eigenschaft einer Active Directory-Gesamtstruktur.

Typ:String[]
Aliase:ForestId
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

IResultObject[]

IResultObject