Get-SCOMAgent
Obtiene los equipos administrados por el agente en un grupo de administración.
Sintaxis
Empty (Es el valor predeterminado).
Get-SCOMAgent
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromManagementServer
Get-SCOMAgent
[-ManagementServer] <ManagementServer>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromAgentNames
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.
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 |
-Credential
Especifica un objeto de PSCredential para la conexión del grupo de administración.
Para obtener un objeto de de Get-Help Get-Credential.
Si especifica un equipo en el parámetro computerName
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 |
-DNSHostName
Especifica el nombre de un host del sistema de nombres de dominio (DNS) del equipo administrado por agente.
Propiedades del parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Nombre |
Conjuntos de parámetros
FromAgentNames
| Posición: | 1 |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-ManagementServer
Especifica un objeto
Propiedades del parámetro
| Tipo: | ManagementServer |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Sra. |
Conjuntos de parámetros
FromManagementServer
| Posición: | 1 |
| Mandatory: | True |
| Valor de la canalización: | True |
| 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
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 |
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.