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 Get-Help Get-Credential.
Se você especificar um computador no parâmetro
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.