Update-SCOMADAgentAssignment
Modifie les paramètres d’une attribution d’agent AD DS.
Syntax
Update-SCOMADAgentAssignment
-AgentAssignment <AgentAssignment>
-PrimaryServer <ManagementServer>
[[-LdapQuery] <String>]
[-Exclude <String[]>]
[-PassThru]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
L’applet de commande Update-SCOMADAgentAssignment modifie les paramètres d’une affectation d’agent services de domaine Active Directory (AD DS). Vous pouvez utiliser cette applet de commande pour modifier les paramètres de requête LDAP et de liste d’exclusion de l’affectation de l’agent. Pour modifier d’autres paramètres de l’affectation de l’agent, supprimez l’affectation 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’affectation 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 de l’agent pour le domaine nommé contoso.com pour renvoyer uniquement des ordinateurs avec des noms correspondant à 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 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Vous demande une confirmation avant d’exécuter l’applet de commande.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Spécifie un objet PSCredential pour la connexion au groupe d’administration.
Pour obtenir un objet PSCredential, utilisez l'applet de commande Get-Credential.
Pour plus d'informations, voir 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Exclude
Spécifie un tableau de noms d’ordinateurs. Operations Manager exclut les ordinateurs que vous spécifiez à partir 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 aucun résultat.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 actuelle au groupe d'administration.
Type: | Connection[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |