Add-SCOMADAgentAssignment
Affecte des ordinateurs gérés par l’agent AD DS au groupe d’administration.
Syntaxe
Add-SCOMADAgentAssignment
[-Domain] <String>
[-PrimaryServer] <ManagementServer>
[-LdapQuery] <String>
[-RunAsProfile <ManagementPackSecureReference>]
[-FailoverServer <ManagementServer[]>]
[-Exclude <String[]>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
L’applet de commande Add-SCOMADAgentAssign ment affecte un ou plusieurs ordinateurs gérés par l’agent Active Directory (AD DS) au groupe d’administration System Center - Operations Manager.
Avant d’utiliser cette applet de commande pour affecter des ordinateurs gérés par l’agent au groupe d’administration, utilisez MOMADAdmin.exe pour créer un conteneur AD DS pour un groupe d’administration Operations Manager dans le domaine des ordinateurs.
Exemples
Exemple 1 : Affecter des ordinateurs gérés par l’agent AD DS au groupe d’administration
PS C:\>$PrimaryServer = Get-SCOMManagementServer -Name "DivMgmtSvr01.fabrikam.net"
PS C:\> $Ldap = "(&(sAMAccountType=805306369)(name=SQLServer*))"
PS C:\> Add-SCOMADAgentAssignment -Domain "fabrikam.net" -PrimaryServer $PrimaryServer -LdapQuery $Ldap -Exclude "SQLServer05.fabrikam.net"Cet exemple affecte un ordinateur géré par l’agent AD DS au groupe d’administration.
La première commande obtient l’objet serveur d’administration nommé DivMgmtSvr01.fabrikam.net et stocke l’objet dans la variable $PrimaryServer.
La deuxième commande spécifie une requête LDAP qui sélectionne les ordinateurs avec des noms tels que SQLServer*.fabrikam.net et stocke l’objet dans la variable $Ldap.
La troisième commande affecte les ordinateurs gérés par l’agent AD DS stockés dans $Ldap au groupe d’administration du domaine fabrikam.net. La commande exclut l’ordinateur nommé SQLServer05.fabrikam.net du groupe d’administration.
Exemple 2 : Définir des basculements pour une affectation d’agent AD DS
PS C:\>$PrimaryServer = Get-SCOMManagementServer -Name "DivMgmtSvr01.fabrikam.net"
PS C:\> $Failovers = Get-SCOMManagementServer -Name "FabrikamSecondary*.fabrikam.net"
PS C:\> $RunAs = Get-SCOMRunAsProfile -Name "Active Directory Based Agent Assignment Account"
PS C:\> $Ldap = "(&(sAMAccountType=805306369)(name=SQLServer*))"
PS C:\> Add-SCOMADAgentAssignment -Domain "fabrikam.net" -PrimaryServer $PrimaryServer -LdapQuery $Ldap -FailoverServer $Failovers -RunAsProfile $RunAsCet exemple affecte un ordinateur géré par l’agent AD DS au groupe d’administration et définit les basculements pour l’agent.
La première commande obtient l’objet serveur d’administration nommé DivMgmtSvr01.fabrikam.net et stocke l’objet dans la variable $PrimaryServer.
La deuxième commande obtient les serveurs d’administration avec un nom tel que FabrikamSecondary*.fabrikam.net et stocke les objets dans la variable $Failovers.
La troisième commande obtient l’objet de profil d’exécution nommé « Compte d’affectation d’agent basé sur Active Directory » et stocke l’objet dans la variable $RunAs.
La quatrième commande spécifie une requête LDAP qui sélectionne les ordinateurs avec des noms tels que SQLServer*.fabrikam.net et stocke le résultat dans la variable $Ldap.
La cinquième commande affecte les ordinateurs gérés par l’agent AD DS stockés dans $Ldap au groupe d’administration du domaine fabrikam.net. La commande spécifie le serveur d’administration principal stocké dans $PrimaryServer pour les ordinateurs gérés par l’agent. La commande spécifie les serveurs d’administration stockés dans $Failovers en tant que basculements pour les ordinateurs gérés par l’agent. La commande spécifie le profil d’identification stocké dans $RunAs pour les ordinateurs gérés par l’agent.
Paramètres
-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 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 |
-Domain
Spécifie le nom du domaine ou du contrôleur de domaine dans lequel résident les agents cibles.
| Type: | String |
| Alias: | DC |
| Position: | 1 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| 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.
| 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 |
-FailoverServer
Spécifie un tableau de noms d’objets ManagementServer. Ce paramètre spécifie les serveurs d’administration que Operations Manager utilise comme basculements pour les agents cibles.
Par défaut, Operations Manager utilise tous les serveurs d’administration non de passerelle pour le basculement.
| Type: | ManagementServer[] |
| 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.
| Type: | String |
| Position: | 3 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| 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 de l’ordinateur géré par l’agent cible.
Pour obtenir un objet
| Type: | ManagementServer |
| Position: | 2 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-RunAsProfile
Spécifie le profil d’identification que Operations Manager utilise pour exécuter le flux de travail de requête AD DS.
Le profil d’identification doit être associé au même compte d’identification que celui que vous spécifiez lorsque vous exécutez MOMADAdmin.exe pour créer un conteneur AD DS pour un groupe d’administration System Center - Operations Manager.
| Type: | ManagementPackSecureReference |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-SCSession
Spécifie un tableau d’objets Connection.
Pour obtenir un objet
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 |