Add-SCOMADAgentAssignment

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

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

El cmdlet Add-SCOMADAgentAssignment asigna uno o varios equipos administrados por agente de Servicios de dominio de Active Directory (AD DS) al grupo de administración 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 = "(&(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 del 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 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 = "(&(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 para el agente.

El primer comando obtiene el objeto del 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 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 el 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.

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

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Especifica un objeto PSCredential para la conexión del grupo de administración. Para obtener un objeto PSCredential, use el cmdlet Get-Credential. 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.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Domain

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

Type:String
Aliases:DC
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Exclude

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

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

-FailoverServer

Especifica una matriz de nombres de objetos ManagementServer . 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.

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

-LdapQuery

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

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 .

Type:ManagementServer
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:ManagementPackSecureReference
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SCSession

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

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.

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False