Freigeben über

Set-CMActiveDirectoryForest

  • Referenz
Modul:
ConfigurationManager

Ändert eigenschaften der Active Directory-Gesamtstruktur in Configuration Manager.

Syntax

Set-CMActiveDirectoryForest
   [-AddPublishingSite <IResultObject[]>]
   [-Description <String>]
   [-EnableDiscovery <Boolean>]
   -InputObject <IResultObject>
   [-PassThru]
   [-Password <SecureString>]
   [-PublishingPath <String>]
   [-RemovePublishingSite <IResultObject[]>]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMActiveDirectoryForest
   [-AddPublishingSite <IResultObject[]>]
   [-Description <String>]
   [-EnableDiscovery <Boolean>]
   -ForestFqdn <String>
   [-PassThru]
   [-Password <SecureString>]
   [-PublishingPath <String>]
   [-RemovePublishingSite <IResultObject[]>]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMActiveDirectoryForest
   [-AddPublishingSite <IResultObject[]>]
   [-Description <String>]
   [-EnableDiscovery <Boolean>]
   -Id <UInt32>
   [-PassThru]
   [-Password <SecureString>]
   [-PublishingPath <String>]
   [-RemovePublishingSite <IResultObject[]>]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Set-CMActiveDirectoryForest ändert Werte für ein Active Directory-Gesamtstrukturobjekt in Configuration Manager. Sie können die Beschreibung bearbeiten, die Ermittlung aktivieren oder deaktivieren und einen vollqualifizierten Domänennamen (FQDN) und einen Veröffentlichungspfad angeben. Sie können ein Active Directory-Gesamtstrukturobjekt nach ID oder FQDN angeben oder das Active Directory-Gesamtstrukturobjekt selbst angeben.

Die Active Directory-Gesamtstrukturermittlung erfordert ein globales Konto zum Ermitteln oder Veröffentlichen in nicht vertrauenswürdigen Gesamtstrukturen.

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: Ändern der Beschreibung einer Active Directory-Gesamtstruktur

PS XYZ:\> Set-CMActiveDirectoryForest -Id "16777217" -Description "AD Forest 01"

Dieser Befehl ändert die Beschreibung einer Active Directory-Gesamtstruktur mit der ID 16777217 in AD-Gesamtstruktur 01.

Parameter

-AddPublishingSite

Typ:IResultObject[]
Aliase:AddPublishingSites
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Gibt eine Beschreibung für ein Active Directory-Gesamtstrukturobjekt an.

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

-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

-EnableDiscovery

Gibt an, ob Active Directory-Standorte und -Subnetze ermittelt werden sollen. Sie müssen eine Active Directory-Gesamtstrukturermittlungsmethode konfigurieren, bevor Sie diesen Parameter verwenden. Der Standardwert ist $False.

Typ:Boolean
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:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

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

Typ:UInt32
Aliase:ForestId
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Gibt ein Active Directory-Gesamtstrukturobjekt in Configuration Manager an.

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

-PassThru

Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.

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

-Password

{{ Kennwortbeschreibung ausfüllen }}

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

-PublishingPath

Gibt mindestens einen Configuration Manager-Standort an, der Standortinformationen in einer Active Directory-Gesamtstruktur veröffentlicht. Sie können eine durch Trennzeichen getrennte Liste in Anführungszeichen verwenden, um mehrere Websites anzugeben.

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

-RemovePublishingSite

Typ:IResultObject[]
Aliase:RemovePublishingSites
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UserName

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

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

IResultObject