Compartilhar via

Get-SCXAgent

  • Referência
Módulo:
OperationsManager

Obtém uma lista de computadores UNIX e Linux gerenciados em um grupo de gerenciamento.

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

O cmdlet Get-SCXAgent recupera os computadores UNIX e Linux gerenciados que correspondem aos critérios de seleção fornecidos. Se nenhum critério de seleção for especificado, todos os computadores UNIX e Linux gerenciados no grupo de gerenciamento serão retornados.

Os resultados são retornados como uma matriz de objetos de computador UNIX e Linux gerenciados.

Exemplos

Exemplo 1: retornar computadores UNIX e Linux gerenciados

PS C:\>Get-SCXAgent

Esse comando retorna todos os computadores UNIX e Linux gerenciados no pool de recursos.

Exemplo 2: retornar computadores UNIX e Linux gerenciados de um pool de recursos

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

O primeiro comando obtém um pool de recursos usando o cmdlet Get-SCOMResourcePool e o armazena na variável $ResourcePool.

O segundo comando retorna todos os computadores UNIX e Linux gerenciados para o pool de recursos em $ResourcePool.

Exemplo 3: retornar computadores UNIX e Linux gerenciados usando o nome

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

Esse comando retorna computadores UNIX e Linux gerenciados com nomes que correspondem a uma lista fornecida de cadeias de caracteres.

Exemplo 4: retornar computadores UNIX e Linux gerenciados usando o pipeline

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

Esse comando fornece o parâmetro Name por meio do pipeline.

Exemplo 5: conectar-se a um pool de recursos e obter um computador gerenciado por nome

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

Esse comando se conecta a um pool de recursos com uma conexão temporária usando as credenciais do usuário atual e retorna apenas os computadores gerenciados que correspondem à propriedade Name .

Parâmetros

-ComputerName

Especifica uma matriz de nomes de computadores. O cmdlet estabelece conexões temporárias com grupos de gerenciamento para esses computadores. Você pode usar nomes netbios, endereços IP ou FQDNs (nomes de domínio totalmente qualificados). Para especificar o computador local, digite o nome do computador, localhost ou um ponto (.).

O serviço de Acesso a Dados do System Center deve estar ativo no computador. Se você não especificar um computador, o cmdlet usará o computador para a conexão do grupo de gerenciamento atual.

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

-Credential

Especifica a conta de usuário na qual a conexão do grupo de gerenciamento é executada. Especifique um objeto PSCredential , como um que o cmdlet Get-Credential retorna, para esse parâmetro. Para obter mais informações sobre objetos de credencial, digite Get-Help Get-Credential.

Se você especificar um computador no parâmetro ComputerName , use uma conta que tenha acesso a esse computador. O padrão é o usuário atual.

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

-ID

Especifica a ID de um objeto de computador UNIX ou Linux gerenciado. Retorna apenas os únicos computadores gerenciados com propriedades de ID que correspondem a esse valor. Esse parâmetro é aceito no pipeline.

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

-Name

Especifica uma lista de nomes de domínio totalmente qualificados para um ou mais computadores UNIX e Linux gerenciados. Retorna apenas os computadores gerenciados que correspondem à propriedade Name .

Você pode incluir caracteres curinga, caso em que todos os computadores que correspondem ao curinga são retornados. Para obter informações sobre como usar caracteres curinga, digite Get-Help About_Wildcards.

Esse parâmetro é aceito no pipeline.

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

-ResourcePool

Especifica um pool de recursos de servidores, um dos quais é atribuído para ser o servidor de gerenciamento atual e o outro servindo como servidores de gerenciamento de backup. Esse parâmetro requer um objeto de pool de recursos e retorna apenas os computadores gerenciados nesse pool de recursos.

Para obter informações sobre como obter um objeto SCOMResourcePool , digite 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 uma matriz de objetos Connection . Para obter objetos Connection , use o cmdlet Get-SCOMManagementGroupConnection .

Se esse parâmetro não for especificado, o cmdlet usará a conexão persistente ativa com um grupo de gerenciamento. Use o parâmetro SCSession para especificar uma conexão persistente diferente. Você pode criar uma conexão temporária com um grupo de gerenciamento usando os parâmetros ComputerName e Credential . Para obter mais informações, digite Get-Help about_OpsMgr_Connections.

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

Saídas

Microsoft.Unix.Computer[]

Esse cmdlet retorna um ou mais objetos de computador que representam computadores UNIX e Linux gerenciados quando os computadores UNIX e Linux correspondem aos critérios de entrada.