Partilhar via

Update-SCXAgent

Módulo:
OperationsManager Module

Atualiza o agente de gerenciamento nos computadores UNIX e Linux especificados para a versão mais recente disponível.

Sintaxe

Default (Predefiniçã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á executada.

O parâmetro do Agent necessário especifica os computadores UNIX e Linux gerenciados de destino a serem desinstalados 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. Este cmdlet aceita SshCredential e WsManCredential parâmetros de entrada. O fornecido parâmetro SshCredential é usado para ações de atualização de agente privilegiado, enquanto o WsManCredential fornecido é usado para comunicação de agente com poucos privilégios. Se o parâmetro SshCredential não for fornecido, o cmdlet tentará usar a conta Run As de manutenção do agente definida associada ao computador de destino.

A saída deste 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 para um computador Linux ou UNIX gerenciado chamado nx1.contoso.com usando o cmdlet Get-SCXAgent. O comando armazena-o 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, em seguida, 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 terceiro comandos.

Exemplo 2: Atualizar um agente de gerenciamento com a conta Run As definida

PS C:\>Get-SCXAgent -Name "nx1.contoso.com" | Update-SCXAgent

Este comando obtém o agente para 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 Run As 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 dos parâmetros

Tipo:

IPersistedUnixComputer[]

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

Conjuntos de parâmetros

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

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

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

-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

-SshCredential

Especifica um privilegiado SshCredential parâmetro usado para executar as ações de atualização do agente. Se esse parâmetro não for especificado, o cmdlet tentará usar a conta Run As de manutenção do agente definida para o agente.

Para obter informações sobre como obter um objeto de credencial SSH, digite Get-Help Get-SCXSSHCredential.

Propriedades dos parâmetros

Tipo:CredentialSet
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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

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

-WsManCredential

Especifica uma credencial usada para comunicação de agente com privilégios baixos por meio do WSMan. Este 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 introduz um nome de utilizador, é-lhe solicitada uma palavra-passe.

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

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 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 antiga do agente
  • Nova versão do Agent
  • status de atualização
  • Descrição

A descrição inclui os detalhes do motivo da falha na atualização.

Notas

  • Este cmdlet inclui 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.