Partager via


Set-CMActiveDirectoryForest

Modifie les propriétés de forêt Active Directory dans Configuration Manager.

Syntaxe

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>]

Description

L’applet de commande Set-CMActiveDirectoryForest modifie les valeurs d’un objet de forêt Active Directory dans Configuration Manager. Vous pouvez modifier la description, activer ou désactiver la découverte, et spécifier un nom de domaine complet (FQDN) et un chemin de publication. Vous pouvez spécifier un objet de forêt Active Directory par ID ou nom de domaine complet, ou vous pouvez fournir l’objet de forêt Active Directory lui-même.

La découverte de forêts Active Directory nécessite un compte global pour découvrir ou publier sur des forêts non approuvées.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Modifier la description d’une forêt Active Directory

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

Cette commande remplace la description d’une forêt Active Directory avec l’ID 16777217 en forêt AD 01.

Paramètres

-AddPublishingSite

Type:IResultObject[]
Alias:AddPublishingSites
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Description

Spécifie une description pour un objet de forêt Active Directory.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-EnableDiscovery

Spécifie s’il faut découvrir des sites et des sous-réseaux Active Directory. Vous devez configurer une méthode de découverte de forêt Active Directory avant d’utiliser ce paramètre. La valeur par défaut est $false.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForestFqdn

Spécifie le nom de domaine complet d’un objet Configuration Manager.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Id

Spécifie un tableau d’ID d’objets Configuration Manager. Vous trouverez la valeur de l’identificateur dans la propriété ForestID d’une forêt Active Directory.

Type:UInt32
Alias:ForestId
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifie un objet de forêt Active Directory dans Configuration Manager.

Type:IResultObject
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-PassThru

Ajoutez ce paramètre pour renvoyer un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette applet de commande peut ne pas générer de sortie.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Password

{{ Remplir la description du mot de passe }}

Type:SecureString
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PublishingPath

Spécifie un ou plusieurs sites Configuration Manager qui publient des informations de site dans une forêt Active Directory. Vous pouvez utiliser une liste séparée par des virgules entre guillemets pour spécifier plusieurs sites.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RemovePublishingSite

Type:IResultObject[]
Alias:RemovePublishingSites
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-UserName

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject