Compartir a través de

Get-SCOMAgent

  • Referencia
Módulo:
OperationsManager

Obtiene los equipos administrados por el agente en un grupo de administración.

Syntax

Get-SCOMAgent
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMAgent
   [-ManagementServer] <ManagementServer>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMAgent
   [-DNSHostName] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Description

El cmdlet Get-SCOMAgent obtiene los equipos administrados por el agente en un grupo de administración. Puede especificar el parámetro DNSHostName para obtener los equipos administrados por el agente en un host del Sistema de nombres de dominio (DNS), o bien puede especificar el parámetro ManagementServer para obtener todos los equipos administrados por agentes secundarios para un servidor de administración principal.

Ejemplos

Ejemplo 1: Obtener todos los agentes del grupo de administración

PS C:\>Get-SCOMAgent -ComputerName "Server01.Contoso.Com"

Este comando establece una conexión temporal con el equipo denominado Server01 y obtiene todos los agentes del grupo de administración.

Ejemplo 2: Obtener los agentes administrados por un servidor de administración

PS C:\>$MgmtServer = Get-SCOMManagementServer "MgmtServer01.Contoso.com"
PS C:\> Get-SCOMAgent -ManagementServer $MgmtServer

En este ejemplo se obtienen equipos administrados por agente administrados por un servidor de administración.

El primer comando obtiene el objeto de servidor de administración denominado MgmtServer01.Contoso.com y almacena el objeto en la variable $MgmtServer.

El segundo comando obtiene los agentes administrados por el servidor de administración almacenados en $MgmtServer.

Ejemplo 3: Obtención de agentes en un grupo de administración mediante el nombre del agente

PS C:\>Get-SCOMAgent -DNSHostName "server01.contoso.com", "Server02*", "*.Contoso.com"

Este comando obtiene agentes denominados server01.contoso.com, que tienen un nombre que comienza por Server02 y que están en el dominio Contoso.com.

Ejemplo 4: Obtener todos los agentes de un dominio

PS C:\>Get-SCOMAgent -DNSHostName "*.Contoso.com" -ComputerName "Server01.Contoso.com"

Este comando establece una conexión temporal con el equipo denominado Server01.Contoso.com y obtiene todos los agentes del dominio Contoso.com.

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

-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

-DNSHostName

Especifica el nombre de un host del Sistema de nombres de dominio (DNS) del equipo administrado por agente.

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

-ManagementServer

Especifica un objeto ManagementServer . Este parámetro especifica el servidor de administración principal del que se van a recuperar todos los agentes secundarios. Para obtener un objeto ManagementServer , use el cmdlet Get-SCOMManagementServer .

Type:ManagementServer
Aliases:MS
Position:1
Default value:None
Required:True
Accept pipeline input:True
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

Salidas

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer