Partager via

Add-SCOMADAgentAssignment

Module:
OperationsManager Module

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

Syntaxe

Default (Par défaut) 

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 = "(&amp;(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 = "(&amp;(sAMAccountType=805306369)(name=SQLServer*))"
PS C:\> Add-SCOMADAgentAssignment -Domain "fabrikam.net" -PrimaryServer $PrimaryServer -LdapQuery $Ldap -FailoverServer $Failovers -RunAsProfile $RunAs

Cet 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.

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

-Domain

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

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
Alias:DC

Jeux de paramètres

(All)
Position:1
Obligatoire:True
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.

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

-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.

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: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.

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:True
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 de l’ordinateur géré 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:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:ManagementPackSecureReference
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

-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.