Compartir a través de

Get-SCXAgent

  • Referencia
Módulo:
OperationsManager

Obtiene una lista de equipos UNIX y Linux administrados en un grupo de administración.

Syntax

Get-SCXAgent
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCXAgent
   [-Name] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCXAgent
   -ID <Guid[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCXAgent
   -ResourcePool <ManagementServicePool>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Description

El cmdlet Get-SCXAgent recupera los equipos UNIX y Linux administrados que coinciden con los criterios de selección proporcionados. Si no se especifica ningún criterio de selección, se devuelven todos los equipos UNIX y Linux administrados del grupo de administración.

Los resultados se devuelven como una matriz de objetos de equipo UNIX y Linux administrados.

Ejemplos

Ejemplo 1: Devolver equipos UNIX y Linux administrados

PS C:\>Get-SCXAgent

Este comando devuelve todos los equipos UNIX y Linux administrados del grupo de recursos.

Ejemplo 2: Devolución de equipos UNIX y Linux administrados desde un grupo de recursos

PS C:\>$ResourcePool = Get-SCOMResourcePool -DisplayName "pool01"
PS C:\> Get-SCXAgent -ResourcePool $ResourcePool

El primer comando obtiene un grupo de recursos mediante el cmdlet Get-SCOMResourcePool y lo almacena en la variable $ResourcePool.

El segundo comando devuelve todos los equipos UNIX y Linux administrados para el grupo de recursos en $ResourcePool.

Ejemplo 3: Devolver equipos UNIX y Linux administrados con el nombre

PS C:\>Get-SCXAgent -Name "nx1.contoso.com,nx2.*","*.development.contoso.com"

Este comando devuelve equipos UNIX y Linux administrados con nombres que coinciden con una lista proporcionada de cadenas.

Ejemplo 4: Devolución de equipos UNIX y Linux administrados mediante la canalización

PS C:\>"server1", "server2", "server3" | Get-SCXAgent

Este comando proporciona el parámetro Name a través de la canalización.

Ejemplo 5: Conexión a un grupo de recursos y obtención de un equipo administrado por nombre

PS C:\>Get-SCXAgent -Name "*development.contoso.com" -ComputerName "server1.contoso.com"

Este comando se conecta a un grupo de recursos con una conexión temporal, mediante las credenciales del usuario actual y devuelve solo los equipos administrados que coinciden con la propiedad Name .

Parámetros

-ComputerName

Especifica una matriz de nombres de equipos. El cmdlet establece conexiones temporales con grupos de administración para estos 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 estar activo 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 la cuenta de usuario con la que se ejecuta la conexión del grupo de administración. Especifique un objeto PSCredential , como el que devuelve el cmdlet Get-Credential , para este parámetro. Para obtener más información sobre los objetos de credenciales, 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

-ID

Especifica el identificador de un objeto de equipo UNIX o Linux administrado. Devuelve solo los únicos equipos administrados con propiedades de identificador que coinciden con este valor. Este parámetro se acepta desde la canalización.

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

-Name

Especifica una lista de nombres de dominio completos para uno o varios equipos UNIX y Linux administrados. Devuelve solo los equipos administrados que coinciden con la propiedad Name .

Puede incluir caracteres comodín, en cuyo caso se devuelven todos los equipos que coincidan con el carácter comodín. Para obtener información sobre el uso de caracteres comodín, escriba Get-Help About_Wildcards.

Este parámetro se acepta desde la canalización.

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

-ResourcePool

Especifica un grupo de recursos de servidores, uno de los cuales está asignado para ser el servidor de administración actual y el otro que actúa como servidores de administración de copias de seguridad. Este parámetro requiere un objeto de grupo de recursos y devuelve solo los equipos administrados de ese grupo de recursos.

Para obtener información sobre cómo obtener un objeto SCOMResourcePool , escriba Get-Help Get-SCOMResourcePool.

Type:ManagementServicePool
Aliases:RP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SCSession

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

Si no se especifica este parámetro, el cmdlet usa la conexión persistente activa a un grupo de administración. Use el parámetro SCSession para especificar una conexión persistente diferente. Puede crear una conexión temporal a un grupo de administración mediante los parámetros ComputerName y Credential . Para obtener más información, escriba Get-Help about_OpsMgr_Connections.

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

Salidas

Microsoft.Unix.Computer[]

Este cmdlet devuelve uno o varios objetos Computer que representan equipos UNIX y Linux administrados cuando los equipos UNIX y Linux coinciden con los criterios de entrada.