Condividi tramite

Update-SCXAgent

  • Riferimento
Modulo:
OperationsManager

Aggiorna l'agente di gestione nei computer UNIX e Linux specificati alla versione più recente disponibile.

Sintassi

Update-SCXAgent
      -Agent <IPersistedUnixComputer[]>
      [-WsManCredential <PSCredential>]
      [-SshCredential <CredentialSet>]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Il cmdlet Update-SCXAgent aggiorna l'agente nei computer specificati alla versione più recente disponibile. Se la versione più recente disponibile dell'agente di gestione è già installata in un computer di destinazione, non viene eseguita alcuna azione.

Il parametro Agent obbligatorio specifica i computer UNIX e Linux gestiti di destinazione da disinstallare e richiede un oggetto computer UNIX e Linux. Per informazioni sul recupero di computer UNIX e Linux gestiti, vedere il cmdlet Get-SCXAgent. Questo cmdlet accetta parametri di input SshCredential e WsManCredential . Il parametro SshCredential fornito viene usato per le azioni di aggiornamento dell'agente con privilegi mentre wsManCredential fornito viene usato per la comunicazione con agente con privilegi bassi. Se il parametro SshCredential non viene fornito, il cmdlet tenta di usare l'account RunAs dell'agente definito associato al computer di destinazione.

L'output di questo cmdlet è una matrice di oggetti computer UNIX o Linux gestiti che rappresentano i sistemi di destinazione aggiornati correttamente.

Esempio

Esempio 1: Aggiornare un agente di gestione

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

Il primo comando ottiene l'agente per un computer Linux o UNIX gestito denominato nx1.contoso.com usando il cmdlet Get-SCXAgent. Il comando lo archivia nella variabile $Agent 01.

Il secondo comando ottiene una credenziale per un utente usando il cmdlet Get-Credential. Il comando richiede l'autenticazione e quindi archivia i risultati nella variabile $WSCredential.

Il terzo comando crea una credenziale con privilegi per un utente usando il cmdlet Get-SCXSSHCredential. Il comando archivia il risultato nella variabile $SSHCredential.

Il comando finale aggiorna l'agente di gestione in $Agent 01 con i valori del secondo e del terzo comando.

Esempio 2: Aggiornare un agente di gestione con l'account RunAs definito

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

Questo comando ottiene l'agente per un computer Linux o UNIX gestito denominato nx1.contoso.com usando Get-SCXAgent. Il comando passa il computer gestito al cmdlet corrente. Il comando aggiorna l'agente di gestione usando l'account RunAs definito.

Parametri

-Agent

Specifica uno o più oggetti computer UNIX o Linux gestiti. Per informazioni su come ottenere un oggetto computer UNIX o Linux gestito, digitare Get-Help Get-SCXAgent.

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

-ComputerName

Specifica una matrice di nomi di computer. Il cmdlet stabilisce connessioni temporanee con i gruppi di gestione per questi computer. È possibile usare nomi NetBIOS, indirizzi IP o nomi di dominio completi (FQDN). Per specificare il computer locale, digitare il nome del computer, localhost o un punto (.).

Il servizio System Center Data Access deve essere attivo nel computer. Se non si specifica un computer, il cmdlet usa il computer per la connessione del gruppo di gestione corrente.

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

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

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

-Credential

Specifica l'account utente in cui viene eseguita la connessione al gruppo di gestione. Specificare un oggetto PSCredential , ad esempio quello restituito dal cmdlet Get-Credential , per questo parametro. Per altre informazioni sugli oggetti credenziali, digitare Get-Help Get-Credential.

Se si specifica un computer nel parametro ComputerName , usare un account che ha accesso a tale computer. Il valore predefinito è l'utente corrente.

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

-SCSession

Specifica una matrice di oggetti Connection . Per ottenere oggetti Connection , usare il cmdlet Get-SCOMManagementGroupConnection .

Se questo parametro non è specificato, il cmdlet usa la connessione persistente attiva a un gruppo di gestione. Usare il parametro SCSession per specificare una connessione persistente diversa. È possibile creare una connessione temporanea a un gruppo di gestione usando i parametri ComputerName e Credential . Per ulteriori informazioni, digitare Get-Help about_OpsMgr_Connections.

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

-SshCredential

Specifica un parametro SshCredential con privilegi usato per eseguire le azioni di aggiornamento dell'agente. Se questo parametro non è specificato, il cmdlet tenta di usare l'account RunAs dell'agente definito per l'agente.

Per informazioni su come ottenere un oggetto credenziali SSH, digitare Get-Help Get-SCXSSHCredential.

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

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

-WsManCredential

Specifica una credenziale usata per la comunicazione con agenti con privilegi bassi tramite WSMan. Questo cmdlet usa questa credenziale per verificare la disponibilità dell'agente.

Digitare un nome utente, ad esempio User01 o immettere un oggetto PSCredential , ad esempio quello restituito dal cmdlet Get-Credential. Quando si digita un nome utente, viene richiesta una password.

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

Output

Microsoft.Unix.Computer[]

Questo cmdlet restituisce una raccolta di risultati dell'aggiornamento, ognuno che rappresenta lo stato di aggiornamento per un computer. Ogni risultato deve contenere le informazioni seguenti:

  • nomehost
  • Sistemi operativi
  • Versione dell'agente precedente
  • Nuova versione dell'agente
  • stato aggiornamento
  • Descrizione

La descrizione include i dettagli del motivo per cui un aggiornamento non è riuscito.

Note

  • Questo cmdlet accetta una raccolta di nomi host in modo enumerato. Raccoglie tutti i nomi host e elabora l'intera raccolta in parallelo alla fine della pipeline.