Partager via

Update-SCOMADAgentAssignment

Module:
OperationsManager Module

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

Syntaxe

Default (Par défaut) 

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 "(&amp;(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 .

Propriétés du paramètre

Type:AgentAssignment
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:PSCredential
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:3
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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 .

Propriétés du paramètre

Type:ManagementServer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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.

Propriétés du paramètre

Type:

Connection[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.