Compartir a través de

Add-SCOMADAgentAssignment

Módulo:
OperationsManager Module

Asigna equipos administrados por agente de AD DS al grupo de administración.

Sintaxis

Default (Es el valor predeterminado). 

Add-SCOMADAgentAssignment
    [-Domain] <String>
    [-PrimaryServer] <ManagementServer>
    [-LdapQuery] <String>
    [-RunAsProfile <ManagementPackSecureReference>]
    [-FailoverServer <ManagementServer[]>]
    [-Exclude <String[]>]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

El cmdlet Add-SCOMADAgentAssignment asigna uno o varios equipos administrados por agente de Active Directory Domain Services (AD DS) al grupo de administración de System Center - Operations Manager.

Antes de usar este cmdlet para asignar equipos administrados por agente al grupo de administración, use MOMADAdmin.exe para crear un contenedor de AD DS para un grupo de administración de Operations Manager en el dominio de los equipos.

Ejemplos

Ejemplo 1: Asignación de equipos administrados por agente de AD DS al grupo de administración

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"

En este ejemplo se asigna un equipo administrado por agente de AD DS al grupo de administración.

El primer comando obtiene el objeto de servidor de administración denominado DivMgmtSvr01.fabrikam.net y almacena el objeto en la variable $PrimaryServer.

El segundo comando especifica una consulta LDAP que selecciona equipos con nombres como SQLServer*.fabrikam.net y almacena el objeto en la variable $Ldap.

El tercer comando asigna los equipos administrados por agente de AD DS almacenados en $Ldap al grupo de administración del dominio de fabrikam.net. El comando excluye el equipo denominado SQLServer05.fabrikam.net del grupo de administración.

Ejemplo 2: Establecimiento de conmutaciones por error para una asignación de agente de 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

En este ejemplo se asigna un equipo administrado por agente de AD DS al grupo de administración y se establecen las conmutaciones por error del agente.

El primer comando obtiene el objeto de servidor de administración denominado DivMgmtSvr01.fabrikam.net y almacena el objeto en la variable $PrimaryServer.

El segundo comando obtiene los servidores de administración con un nombre como FabrikamSecondary*.fabrikam.net y almacena los objetos en la variable $Failovers.

El tercer comando obtiene el objeto De perfil Runs As denominado "Cuenta de asignación de agente basado en Active Directory" y almacena el objeto en la variable $RunAs.

El cuarto comando especifica una consulta LDAP que selecciona equipos con nombres como SQLServer*.fabrikam.net y almacena el resultado en la variable $Ldap.

El quinto comando asigna los equipos administrados por agente de AD DS almacenados en $Ldap al grupo de administración del dominio de fabrikam.net. El comando especifica el servidor de administración principal almacenado en $PrimaryServer para los equipos administrados por agente. El comando especifica los servidores de administración almacenados en $Failovers como conmutaciones por error para los equipos administrados por agente. El comando especifica el perfil de ejecución almacenado en $RunAs para los equipos administrados por agente.

Parámetros

-ComputerName

Especifica una matriz de nombres de equipos. Puede usar nombres NetBIOS, direcciones IP o nombres de dominio completos (FQDN). Para especificar el equipo local, escriba el nombre del equipo, localhost o un punto (.).

El servicio de acceso a datos de System Center debe ejecutarse en el equipo. Si no especifica un equipo, el cmdlet usa el equipo para la conexión del grupo de administración actual.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Credential

Especifica un objeto de PSCredential para la conexión del grupo de administración. Para obtener un objeto de de PSCredential, use el cmdlet get-credential de . Para obtener más información, escriba Get-Help Get-Credential.

Si especifica un equipo en el parámetro computerName , use una cuenta que tenga acceso a ese equipo. El valor predeterminado es el usuario actual.

Propiedades del parámetro

Tipo:PSCredential
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Domain

Especifica el nombre del dominio o controlador de dominio en el que residen los agentes de destino.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Distrito de Columbia

Conjuntos de parámetros

(All)
Posición:1
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Exclude

Especifica una matriz de nombres de equipos. Operations Manager excluye los equipos que especifique de la asignación del agente.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-FailoverServer

Especifica una matriz de nombres de ManagementServer objetos. Este parámetro especifica los servidores de administración que Operations Manager usa como conmutaciones por error para los agentes de destino.

De forma predeterminada, Operations Manager usa todos los servidores de administración que no son de puerta de enlace para la conmutación por error.

Propiedades del parámetro

Tipo:

ManagementServer[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-LdapQuery

Especifica la consulta LDAP en el dominio que selecciona los equipos del agente de destino.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:3
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PrimaryServer

Especifica un objeto ManagementServer. Este parámetro especifica el servidor de administración principal para el equipo administrado por agente de destino. Para obtener un objeto ManagementServer, use el cmdlet get-SCOMManagementServer de .

Propiedades del parámetro

Tipo:ManagementServer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:2
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RunAsProfile

Especifica el perfil de ejecución que Operations Manager usa para ejecutar el flujo de trabajo de consulta de AD DS.

El perfil de ejecución debe estar asociado a la misma cuenta de ejecución que especifique al ejecutar MOMADAdmin.exe para crear un contenedor de AD DS para un grupo de administración de System Center - Operations Manager.

Propiedades del parámetro

Tipo:ManagementPackSecureReference
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SCSession

Especifica una matriz de objetos connection. Para obtener un objeto connection , use el cmdlet get-SCOMManagementGroupConnection de .

Un objeto de conexión representa una conexión a un servidor de administración. El valor predeterminado es la conexión del grupo de administración actual.

Propiedades del parámetro

Tipo:

Connection[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.