Partilhar via


Get-SCXAgent

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

Sintaxe

Empty (Predefinição)

Get-SCXAgent
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromAgentNamesParameterSetName

Get-SCXAgent
    [-Name] <String[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromAgentGuidsParameterSetName

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

FromResourcePoolParameterSetName

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

Este 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 no $ResourcePool.

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

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

Este 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

Este comando fornece o parâmetro Name através do pipeline.

Exemplo 5: Conectar-se a um pool de recursos e obter um computador gerenciado pelo 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 Nome .

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 atual do grupo de gerenciamento.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Credential

Especifica a conta de usuário sob a 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.

Propriedades dos parâmetros

Tipo:PSCredential
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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. Este parâmetro é aceito do pipeline.

Propriedades dos parâmetros

Tipo:

Guid[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

FromAgentGuidsParameterSetName
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

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

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

Este parâmetro é aceito do pipeline.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:Nome de Exibição

Conjuntos de parâmetros

FromAgentNamesParameterSetName
Position:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ResourcePool

Especifica um pool de recursos de servidores, um dos quais é atribuído como o servidor de gerenciamento atual e o outro como servidores de gerenciamento de backup. Este 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.

Propriedades dos parâmetros

Tipo:ManagementServicePool
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:RP

Conjuntos de parâmetros

FromResourcePoolParameterSetName
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:

Connection[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Saídas

Microsoft.Unix.Computer

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