Partilhar via

Update-SCXAgent

  • Referência
Módulo:
OperationsManager

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

Syntax

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 gestão já estiver instalada num computador direcionado, não serão tomadas medidas.

O parâmetro de agente necessário especifica os computadores geridos pela UNIX e Linux para desinstalar e requer um objeto de computador UNIX e Linux. Para obter informações sobre a recuperação de computadores GERIDOS UNIX e Linux, consulte o Get-SCXAgent cmdlet. Este cmdlet aceita parâmetros de entrada SshCredential e WsManCredential . O parâmetro SshCredential fornecido é utilizado para ações privilegiadas de atualização de agentes enquanto o WsManCredential fornecido é utilizado para comunicação de agentes de baixos privilégios. Se o parâmetro SshCredential não for fornecido, o cmdlet tenta utilizar a manutenção do agente definido Run As account associada ao computador visado.

A saída deste cmdlet é uma série de objetos de computador geridos UNIX ou Linux que representam os sistemas-alvo que foram atualizados com sucesso.

Exemplos

Exemplo 1: Atualizar um agente de gestão

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 gerido Linux ou UNIX chamado nx1.contoso.com usando o Get-SCXAgent cmdlet. O comando armazena-o na variável $Agent 01.

O segundo comando obtém uma credencial para um utilizador utilizando o Get-Credential cmdlet. O comando solicita a autenticação e, em seguida, armazena os resultados na variável $WSCredential.

O terceiro comando cria uma credencial privilegiada para um utilizador utilizando o Get-SCXSSHCredential cmdlet. O comando armazena o resultado na variável $SSHCredential.

O comando final atualiza o agente de gestão em $Agent 01 com os valores do segundo e terceiro comandos.

Exemplo 2: Atualizar um agente de gestão com a conta Run As definida

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

Este comando obtém o agente de um computador linux ou UNIX gerido chamado nx1.contoso.com usando o Get-SCXAgent. O comando passa o computador gerido para o cmdlet atual. O comando atualiza o agente de gestão utilizando a conta Run As definida.

Parâmetros

-Agent

Especifica um ou mais objetos de computador GERIDOS UNIX ou Linux. Para obter informações sobre como obter um objeto de computador UNIX ou Linux gerido, escreva Get-Help Get-SCXAgent.

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

-ComputerName

Especifica uma série de nomes de computadores. O cmdlet estabelece ligações temporárias com grupos de gestão para estes computadores. Pode utilizar nomes NetBIOS, endereços IP ou nomes de domínio totalmente qualificados (FQDNs). Para especificar o computador local, digite o nome do computador, local local ou um ponto (.).

O serviço de Acesso a Dados do Centro de Sistemas deve estar ativo no computador. Se não especificar um computador, o cmdlet utiliza o computador para a ligação do grupo de gestão atual.

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

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Especifica a conta de utilizador sob a qual a ligação do grupo de gestão é executado. Especifique um objeto PSCredential , tal como aquele que o cmdlet Get-Credential devolve, para este parâmetro. Para obter mais informações sobre objetos credenciais, escreva Get-Help Get-Credential.

Se especificar um computador no parâmetro ComputerName , utilize uma conta que tenha acesso a esse computador. A predefinição é o utilizador atual.

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

-SCSession

Especifica uma matriz de objetos de ligação . Para obter objetos de ligação , utilize o cmdlet Get-SCOMManagementGroupConnection .

Se este parâmetro não for especificado, o cmdlet utiliza a ligação persistente ativa a um grupo de gestão. Utilize o parâmetro SCSession para especificar uma ligação persistente diferente. Pode criar uma ligação temporária a um grupo de gestão utilizando os parâmetros ComputerName e Credential . Para mais informações, insira Get-Help about_OpsMgr_Connections.

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

-SshCredential

Especifica um parâmetro SshCredential privilegiado utilizado para executar as ações de atualização do agente. Se este parâmetro não for especificado, o cmdlet tenta utilizar a manutenção do agente definido Executar como conta para o agente.

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

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WsManCredential

Especifica uma credencial usada para comunicação de agentes privilegiados através do WSMan. Este cmdlet utiliza esta credencial para verificar a disponibilidade do agente.

Digite um nome de utilizador, como Utilizador01 ou introduza um objeto PSCredential , tal como um que é devolvido pelo Get-Credential cmdlet. Quando escreve um nome de utilizador, é-lhe solicitada uma palavra-passe.

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

Saídas

Microsoft.Unix.Computer[]

Este cmdlet devolve uma coleção de resultados de upgrade, cada um representando o estado de upgrade de um computador. Cada resultado deve conter as seguintes informações:

  • Hostname (Nome do anfitrião)
  • Sistemas operativos
  • Versão do Agente Antigo
  • Versão new agent
  • estado de atualização
  • Descrição

A descrição inclui os detalhes do porquê de uma atualização ter falhado.

Notas

  • Este cmdlet acolhe uma coleção de nomes de anfitriões de forma enumerada. Recolhe todos os nomes dos anfitriões e processa toda a coleção em paralelo no final do oleoduto.