Update-SCXAgent
Atualiza o agente de gerenciamento nos computadores UNIX e Linux especificados para a versão mais recente disponível.
Sintaxe
Default (Padrão)
Update-SCXAgent
-Agent <IPersistedUnixComputer[]>
[-WsManCredential <PSCredential>]
[-SshCredential <CredentialSet>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Update-SCXAgent atualiza o agente nos computadores especificados para a versão mais recente disponível. Se a versão mais recente disponível do agente de gerenciamento já estiver instalada em um computador de destino, nenhuma ação será tomada.
O parâmetro Agent necessário especifica os computadores UNIX e Linux gerenciados de destino para desinstalar e requer um objeto de computador UNIX e Linux. Para obter informações sobre como recuperar computadores UNIX e Linux gerenciados, consulte o cmdlet Get-SCXAgent. Esse cmdlet aceita parâmetros de entrada SshCredential e WsManCredential. O parâmetro SshCredential fornecido é usado para ações de atualização de agente privilegiado, enquanto o WsManCredential fornecido é usado para comunicação de agente com baixo privilégio. Se o parâmetro SshCredential não for fornecido, o cmdlet tentará usar a conta Executar como de manutenção do agente definida associada ao computador de destino.
A saída desse cmdlet é uma matriz de objetos de computador UNIX ou Linux gerenciados que representam os sistemas de destino que foram atualizados com êxito.
Exemplos
Exemplo 1: atualizar um agente de gerenciamento
PS C:\>$Agent01 = Get-SCXAgent -Name "nx1.contoso.com"
PS C:\> $WSCredential = Get-Credential "DavidChew"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key "C:\keys\key21.ppk" -ElevationType sudo
PS C:\> Update-SCXAgent -SSHCredential $SSHCredential -WSManCredential $WSCredential -Agent $Agent01
O primeiro comando obtém o agente de um computador Linux ou UNIX gerenciado chamado nx1.contoso.com usando o cmdlet Get-SCXAgent. O comando o armazena na variável $Agent 01.
O segundo comando obtém uma credencial para um usuário usando o cmdlet Get-Credential. O comando solicita autenticação e armazena os resultados na variável $WSCredential.
O terceiro comando cria uma credencial privilegiada para um usuário usando o cmdlet Get-SCXSSHCredential. O comando armazena o resultado na variável $SSHCredential.
O comando final atualiza o agente de gerenciamento em $Agent 01 com os valores do segundo e do terceiro comandos.
Exemplo 2: atualizar um agente de gerenciamento com a conta Executar como definida
PS C:\>Get-SCXAgent -Name "nx1.contoso.com" | Update-SCXAgent
Esse comando obtém o agente de um computador Linux ou UNIX gerenciado chamado nx1.contoso.com usando Get-SCXAgent. O comando passa o computador gerenciado para o cmdlet atual. O comando atualiza o agente de gerenciamento usando a conta Executar como definida.
Parâmetros
-Agent
Especifica um ou mais objetos de computador UNIX ou Linux gerenciados.
Para obter informações sobre como obter um objeto de computador UNIX ou Linux gerenciado, digite Get-Help Get-SCXAgent.
Propriedades do parâmetro
| Tipo: | IPersistedUnixComputer[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-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.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Credential
Especifica a conta de usuário na qual a conexão do grupo de gerenciamento é executada.
Especifique um objeto 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 do parâmetro
| Tipo: | PSCredential |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SCSession
Especifica uma matriz de objetos Connection.
Para obter objetos
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 Get-Help about_OpsMgr_Connections.
Propriedades do parâmetro
| Tipo: | Connection[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SshCredential
Especifica um parâmetro de SshCredential de
Para obter informações sobre como obter um objeto de credencial SSH, digite Get-Help Get-SCXSSHCredential.
Propriedades do parâmetro
| Tipo: | CredentialSet |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WsManCredential
Especifica uma credencial usada para comunicação de agente de baixo privilégio por meio do WSMan. Esse cmdlet usa essa credencial para verificar a disponibilidade do agente.
Digite um nome de usuário, como User01 ou insira um objeto PSCredential, como um que é retornado pelo cmdlet Get-Credential. Quando você digita um nome de usuário, você é solicitado a obter uma senha.
Propriedades do parâmetro
| Tipo: | PSCredential |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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
Esse cmdlet retorna uma coleção de resultados de atualização, cada um representando o status de atualização de um computador. Cada resultado deve conter as seguintes informações:
- Nome do host
- Sistemas operacionais
- Versão do Agente Antigo
- Nova versão do Agente
- status da atualização
- Descrição
A descrição inclui os detalhes de por que uma atualização falhou.
Observações
- Este cmdlet usa uma coleção de nomes de host de forma enumerada. Ele coleta todos os nomes de host e processa toda a coleção em paralelo no final do pipeline.