Partager via

Update-SCOMADAgentAssignment

  • Référence
Module:
OperationsManager

Modifie les paramètres d’une affectation d’agent AD DS.

Syntaxe

Update-SCOMADAgentAssignment
      -AgentAssignment <AgentAssignment>
      -PrimaryServer <ManagementServer>
      [[-LdapQuery] <String>]
      [-Exclude <String[]>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

La cmdlet Update-SCOMADAgentAssignment modifie les paramètres d’une affectation d’agent Active Directory Domain Services (AD DS). Vous pouvez utiliser cette applet de commande pour modifier les paramètres de la requête LDAP et de la liste d’exclusion de l’affectation de l’agent. Pour modifier d’autres paramètres de l’affectation de l’agent, supprimez l’attribution de l’agent et recréez-la.

Exemples

Exemple 1 : Modifier la requête LDAP pour une affectation d’agent

PS C:\>Get-SCOMADAgentAssignment -Domain "contoso.com" | Update-SCOMADAgentAssignment -LdapQuery "(&(sAMAccountType=805306369)(name=SQLSERVER*))"

Cette commande obtient l’affectation de l’agent AD DS pour un domaine. La commande utilise l’applet de commande Get-SCOMADAgentAssignment pour obtenir l’attribution de l’agent AD DS nommée contoso.com et transmet le résultat à l’applet de commande Update-SCOMADAgentAssignment à l’aide de l’opérateur de pipeline. La commande modifie la requête LDAP de l’affectation d’agent pour le domaine nommé contoso.com pour retourner uniquement les ordinateurs avec des noms qui correspondent à SQLSERVER.

Paramètres

-AgentAssignment

Spécifie un objet AgentAssignment. Pour obtenir un objet AgentAssignment, utilisez l’applet de commande Get-SCOMADAgentAssignment .

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

-ComputerName

Spécifie un tableau de noms d’ordinateurs. Vous pouvez utiliser des noms NetBIOS, des adresses IP ou des noms de domaine complets (FQDN). Pour spécifier l’ordinateur local, tapez le nom de l’ordinateur, localhost ou un point (.).

Le service System Center Data Access doit s’exécuter sur l’ordinateur. Si vous ne spécifiez pas d’ordinateur, l’applet de commande utilise l’ordinateur pour la connexion de groupe d’administration actuelle.

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

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

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

-Credential

Spécifie un objet PSCredential pour la connexion de groupe d’administration. Pour obtenir un objet PSCredential, utilisez l’applet de commande Get-Credential . Pour plus d’informations, tapez Get-Help Get-Credential.

Si vous spécifiez un ordinateur dans le paramètre ComputerName, utilisez un compte qui a accès à cet ordinateur. La valeur par défaut est l’utilisateur actuel.

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

-Exclude

Spécifie un tableau de noms d’ordinateurs. Operations Manager exclut les ordinateurs que vous spécifiez de l’affectation de l’agent. Operations Manager exclut ces ordinateurs même si la requête LDAP retourne les ordinateurs.

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

-LdapQuery

Spécifie la requête LDAP dans le domaine qui sélectionne les ordinateurs de l’agent cible. Si vous ne spécifiez pas ce paramètre, l’applet de commande utilise la requête LDAP actuelle.

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

-PassThru

Indique que l’applet de commande crée ou modifie un objet qu’une commande peut utiliser dans le pipeline. Par défaut, cette applet de commande ne génère aucune 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

-PrimaryServer

Spécifie un objet ManagementServer. Ce paramètre spécifie le serveur d’administration principal pour les ordinateurs gérés par l’agent cible. Pour obtenir un objet ManagementServer, utilisez l’applet de commande Get-SCOMManagementServer .

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

-SCSession

Spécifie un tableau d’objets Connection. Pour obtenir un objet Connection, utilisez l’applet de commande Get-SCOMManagementGroupConnection .

Un objet de connexion représente une connexion à un serveur d’administration. La valeur par défaut est la connexion de groupe d’administration actuelle.

Type:Connection[]
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

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

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