Partager via

Add-SCOMADAgentAssignment

  • Référence
Module:
OperationsManager

Affecte des ordinateurs gérés par l’agent AD DS au groupe d’administration.

Syntax

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-SCOMADAgentAssignment affecte un ou plusieurs ordinateurs gérés par l’agent services de domaine 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 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 montre comment affecter un ordinateur géré par un 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 portant 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 dans le domaine fabrikam.net. La commande exclut du groupe d’administration l’ordinateur nommé SQLServer05.fabrikam.net.

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 $RunAs

Cet exemple montre comment affecter un ordinateur géré par l’agent AD DS au groupe d’administration et définir les basculements de 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 portant 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 dans le domaine fabrikam.net. La commande spécifie le serveur d’administration principal stocké dans $PrimaryServer pour les ordinateurs gérés par agent. La commande spécifie les serveurs d’administration stockés dans $Failovers en tant que basculements pour les ordinateurs gérés par agent. La commande spécifie le profil d’identification stocké dans $RunAs pour les ordinateurs gérés par 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 être en cours d’exécution sur l’ordinateur. Si vous ne spécifiez pas d’ordinateur, l’applet de commande utilise l’ordinateur pour la connexion actuelle au groupe d’administration.

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

-Domain

Spécifie le nom du domaine ou du contrôleur de domaine dans lequel résident les agents cibles.

Type:String
Aliases:DC
Position:1
Default value:None
Required:True
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 de l’affectation d’agent.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FailoverServer

Spécifie un tableau de noms d’objets ManagementServer . Ce paramètre spécifie les serveurs d’administration qu’Operations Manager utilise comme basculements pour les agents cibles.

Par défaut, Operations Manager utilise tous les serveurs d’administration hors passerelle pour le basculement.

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

Type:String
Position:3
Default value:None
Required:True
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 l’ordinateur géré par agent cible. Pour obtenir un objet ManagementServer , utilisez l’applet de commande Get-SCOMManagementServer .

Type:ManagementServer
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RunAsProfile

Spécifie le profil d’identification utilisé par Operations Manager 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
Default value:None
Required:False
Accept pipeline input:False
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