Partager via


Set-CMDiscoveryMethod

Modifie les paramètres de configuration d’une méthode de découverte.

Syntaxe

Set-CMDiscoveryMethod
   [-ActiveDirectoryForestDiscovery]
   [-EnableActiveDirectorySiteBoundaryCreation <Boolean>]
   [-Enabled <Boolean>]
   [-EnableSubnetBoundaryCreation <Boolean>]
   [-PassThru]
   [-PollingSchedule <IResultObject>]
   [-SiteCode <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDiscoveryMethod
   [-ActiveDirectoryContainer <String[]>]
   [-ActiveDirectorySystemDiscovery]
   [-AddActiveDirectoryContainer <String[]>]
   [-AddAdditionalAttribute <String[]>]
   [-ClearActiveDirectoryContainer]
   [-DeltaDiscoveryMins <Int32>]
   [-Enabled <Boolean>]
   [-EnableDeltaDiscovery <Boolean>]
   [-EnableFilteringExpiredLogon <Boolean>]
   [-EnableFilteringExpiredPassword <Boolean>]
   [-EnableIncludeGroup <Boolean>]
   [-EnableRecursive <Boolean>]
   [-IncludeGroup]
   [-PassThru]
   [-PollingSchedule <IResultObject>]
   [-Recursive]
   [-RemoveActiveDirectoryContainer <String[]>]
   [-RemoveAdditionalAttribute <String[]>]
   [-SiteCode <String>]
   [-TimeSinceLastLogonDays <Int32>]
   [-TimeSinceLastPasswordUpdateDays <Int32>]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDiscoveryMethod
   [-ActiveDirectoryContainer <String[]>]
   [-ActiveDirectoryUserDiscovery]
   [-AddActiveDirectoryContainer <String[]>]
   [-AddAdditionalAttribute <String[]>]
   [-ClearActiveDirectoryContainer]
   [-DeltaDiscoveryMins <Int32>]
   [-Enabled <Boolean>]
   [-EnableDeltaDiscovery <Boolean>]
   [-EnableIncludeGroup <Boolean>]
   [-EnableRecursive <Boolean>]
   [-IncludeGroup]
   [-PassThru]
   [-PollingSchedule <IResultObject>]
   [-Recursive]
   [-RemoveActiveDirectoryContainer <String[]>]
   [-RemoveAdditionalAttribute <String[]>]
   [-SiteCode <String>]
   [-UserName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDiscoveryMethod
   [-ActiveDirectoryGroupDiscovery]
   [-AddGroupDiscoveryScope <ADGroupDiscoveryScope[]>]
   [-ClearActiveDirectoryContainer]
   [-DeltaDiscoveryMins <Int32>]
   [-DiscoverDistributionGroupMembership <Boolean>]
   [-Enabled <Boolean>]
   [-EnableDeltaDiscovery <Boolean>]
   [-EnableFilteringExpiredLogon <Boolean>]
   [-EnableFilteringExpiredPassword <Boolean>]
   [-PassThru]
   [-PollingSchedule <IResultObject>]
   [-RemoveGroupDiscoveryScope <String[]>]
   [-SiteCode <String>]
   [-TimeSinceLastLogonDays <Int32>]
   [-TimeSinceLastPasswordUpdateDays <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDiscoveryMethod
   [-Enabled <Boolean>]
   [-NetworkDiscovery]
   [-NetworkDiscoveryType <NetworkDiscoveryType>]
   [-PassThru]
   [-SiteCode <String>]
   [-SlowNetworkSpeed <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDiscoveryMethod
   [-Enabled <Boolean>]
   [-Heartbeat]
   [-PassThru]
   [-PollingSchedule <IResultObject>]
   [-SiteCode <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

L’applet de commande Set-CMDiscoveryMethod modifie les paramètres de configuration d’une méthode de découverte. La découverte identifie les ressources d’ordinateur et d’utilisateur que Configuration Manager peut gérer. Lorsque Configuration Manager découvre une ressource, Configuration Manager crée un enregistrement dans la base de données Configuration Manager pour la ressource et ses informations associées. Vous pouvez ensuite utiliser les informations de découverte pour vous aider à installer le client Configuration Manager et à créer des requêtes et des regroupements personnalisés afin de regrouper logiquement les ressources pour les tâches de gestion associé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 découverte de réseau

PS XYZ:\> Set-CMDiscoveryMethod -NetworkDiscovery -SiteCode "CM4" -Enabled $True -NetworkDiscoveryType ToplogyAndClient -SlowNetworkSpeed $True

Cette commande modifie la découverte du réseau pour le site qui a le code de site CM4. La commande spécifie la topologie et la découverte du réseau client, ainsi que l’option de vitesse réseau lente. La commande active également la découverte.

Exemple 2 : Modifier la découverte du système Active Directory

PS XYZ:\> $Schedule = New-CMSchedule -RecurInterval Minutes -Start "2012/10/20 00:00:00" -End "2013/10/20 00:00:00" -RecurCount 10
PS XYZ:\> Set-CMDiscoveryMethod -ActiveDirectorySystemDiscovery -SiteCode "CM4" -AddAdditionalAttribute "331", "431", "134" -DeltaDiscoveryIntervalMinutes 8 -Enabled $True -EnableDeltaDiscovery $True -EnableFilteringExpiredLogon $True -PollingSchedule $Schedule -RemoveAdditionalAttribute "123","cn" -TimeSinceLastLogonDays 80

La première commande crée un objet de planification à l’aide de l’applet de commande New-CMSchedule et le stocke dans la variable $Schedule.

La deuxième commande active la découverte de l’ordinateur pour le site qui a le code de site CM4. La commande spécifie l’objet de planification stocké dans la variable $Schedule comme planification d’interrogation et permet à la découverte delta de rechercher les ordinateurs nouveaux et modifiés depuis la dernière découverte. La commande spécifie que la découverte delta a lieu toutes les 8 minutes.

La deuxième commande limite également les ordinateurs trouvés à ceux auxquels un utilisateur s’est connecté au cours des 80 derniers jours. En outre, la commande ajoute et supprime les attributs spécifiés des attributs utilisés pour limiter les ordinateurs.

Exemple 3 : Modifier la découverte de forêt

PS XYZ:\> $Schedule = New-CMSchedule -RecurInterval Minutes -Start "2012/10/20 00:00:00" -End "2013/10/20 00:00:00" -RecurCount 10
PS XYZ:\> Set-CMDiscoveryMethod -ActiveDirectoryForestDiscovery -SiteCode "CM4" -EnableActiveDirectorySiteBoundaryCreation $True -Enabled $True  -EnableSubnetBoundaryCreation $True -PollingSchedule $Schedule

La première commande crée un objet de planification à l’aide de l’applet de commande New-CMSchedule , puis le stocke dans la variable $Schedule.

La deuxième commande active ce site de découverte qui a le code de site CM4. La commande spécifie l’objet de planification stocké dans la variable $Schedule comme intervalle d’interrogation et active la création de limites Active Directory et la création de limites de sous-réseau.

Exemple 4 : Activer la découverte des pulsations

PS XYZ:\> $Schedule = New-CMSchedule -RecurInterval Minutes -Start "2012/10/20 00:00:00" -End "2013/10/20 00:00:00" -RecurCount 10
PS XYZ:\> Set-CMDiscoveryMethod -Heartbeat -SiteCode "CM4" -Enabled $True -PollingSchedule $Schedule

La première commande crée un objet de planification à l’aide de l’applet de commande New-CMSchedule et le stocke dans la variable $Schedule.

La deuxième commande active la découverte des pulsations et spécifie l’objet stocké dans la variable $Schedule comme planification d’interrogation pour le site dont le code de site est CM4.

Paramètres

-ActiveDirectoryContainer

Spécifie un tableau de noms de conteneurs 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

-ActiveDirectoryForestDiscovery

Indique que la méthode de découverte découvre les groupes de sécurité, y compris les groupes locaux, globaux et universels à partir d’emplacements spécifiés dans les services de domaine Active Directory (AD DS).

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

-ActiveDirectoryGroupDiscovery

Indique que la méthode de découverte découvre des informations supplémentaires, notamment l’unité d’organisation de l’ordinateur et l’appartenance au groupe, sur les ordinateurs précédemment découverts à partir d’emplacements spécifiés dans AD DS.

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

-ActiveDirectorySystemDiscovery

Indique que la méthode de découverte détecte des ordinateurs à partir d’emplacements spécifiés dans AD DS.

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

-ActiveDirectoryUserDiscovery

Indique que la méthode de découverte découvre des utilisateurs à partir d’emplacements spécifiés dans AD DS.

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

-AddActiveDirectoryContainer

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

-AddAdditionalAttribute

Spécifie un tableau d’attributs d’objet Active Directory. L’applet de commande ajoute ces attributs à la liste des attributs découverts par Configuration Manager.

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

-AddGroupDiscoveryScope

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

-ClearActiveDirectoryContainer

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

-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

-DeltaDiscoveryMins

Type:Int32
Alias:DeltaDiscoveryIntervalMinutes, DeltaDiscoveryIntervalMins
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

-DiscoverDistributionGroupMembership

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

-EnableActiveDirectorySiteBoundaryCreation

Indique si Configuration Manager crée des limites Active Directory à partir des informations de découverte AD DS.

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

-Enabled

Indique s’il faut activer la découverte Configuration Manager. Si vous spécifiez la valeur $False, Configuration Manager ne découvre pas les ressources à l’aide de cette découverte.

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

-EnableDeltaDiscovery

Indique si Configuration Manager détecte les ressources créées ou modifiées dans AD DS depuis le dernier cycle de découverte. Si vous spécifiez une valeur de $True pour ce paramètre, spécifiez une valeur pour le paramètre DeltaDiscoveryIntervalMinutes .

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

-EnableFilteringExpiredLogon

Indique si Configuration Manager détecte uniquement les ordinateurs qui se sont connectés à un domaine au cours d’un nombre de jours spécifié. Spécifiez le nombre de jours à l’aide du paramètre TimeSinceLastLogonDays .

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

-EnableFilteringExpiredPassword

Indique si Configuration Manager détecte uniquement les ordinateurs qui ont mis à jour le mot de passe de leur compte d’ordinateur dans un nombre de jours spécifié. Spécifiez le nombre de jours à l’aide du paramètre TimeSinceLastPasswordUpdateDays .

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

-EnableIncludeGroup

{{ Fill EnableIncludeGroup Description }}

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

-EnableRecursive

{{ Fill EnableRecursive Description }}

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

-EnableSubnetBoundaryCreation

Indique si Configuration Manager crée des limites de plage d’adresses IP à partir des informations de découverte AD DS.

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

-Heartbeat

Indique que la méthode de découverte met à jour les enregistrements de découverte pour les clients Configuration Manager dans la base de données Configuration Manager sans découvrir de nouvelles ressources.

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

-IncludeGroup

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

-NetworkDiscovery

Indique que la méthode de découverte recherche dans l’infrastructure réseau des périphériques réseau, tels que des imprimantes, des routeurs et des ponts, qui ont des adresses IP.

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

-NetworkDiscoveryType

Spécifie le type de découverte de réseau. Si vous spécifiez le paramètre NetworkDiscovery , spécifiez l’un des types suivants :

  • ToplogyAndClient. La découverte recherche la topologie de votre réseau et des appareils clients potentiels.
  • ToplogyClientAndClientOperatingSystem. La découverte recherche la topologie de votre réseau. La découverte recherche les appareils clients potentiels ainsi que leurs systèmes d’exploitation et versions.
  • Topologie. La découverte recherche la topologie de votre réseau en découvrant les sous-réseaux ip et les routeurs.
Type:NetworkDiscoveryType
Valeurs acceptées:Topology, TopologyAndClient, ToplogyAndClient, TopologyClientAndClientOperatingSystem, ToplogyClientAndClientOperatingSystem
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
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

-PollingSchedule

Spécifie un objet de planification. Pour obtenir un objet de planification, utilisez l’applet de commande New-CMSchedule . La planification d’interrogation détermine la fréquence à laquelle Configuration Manager tente de découvrir des groupes, des systèmes ou des données utilisateur.

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

-Recursive

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

-RemoveActiveDirectoryContainer

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

-RemoveAdditionalAttribute

Spécifie un tableau d’attributs d’objet Active Directory. L’applet de commande supprime ces attributs de la liste des attributs découverts par Configuration Manager.

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

-RemoveGroupDiscoveryScope

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

-SiteCode

Spécifie le code de site pour un site Configuration Manager.

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

-SlowNetworkSpeed

Indique si Configuration Manager apporte des ajustements à ses paramètres de découverte pour les réseaux dont la bande passante est faible.

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

-TimeSinceLastLogonDays

Spécifie le nombre de jours depuis la dernière ouverture de session lorsque le paramètre EnableFilteringExpiredLogon avait une valeur de $True.

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

-TimeSinceLastPasswordUpdateDays

Spécifie le nombre de jours depuis la dernière mise à jour du mot de passe lorsque le paramètre EnableFilteringExpiredPassword avait une valeur de $True.

Type:Int32
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

{{ Fill UserName Description }}

Type:String
Alias:DiscoveryAccountUserName
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

None