Get-SCOMAgent

  • Referencia
Módulo:
OperationsManager

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

Sintaxis

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 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: Obtener 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 con 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 de 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.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DNSHostName

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

Tipo:String[]
Alias:Name
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ManagementServer

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

Tipo:ManagementServer
Alias:MS
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:Connection[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Salidas

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer