Dela via

Uninstall-SCXAgent

  • Referens
Modul:
OperationsManager

Avinstallerar hanteringsagenten på de angivna hanterade UNIX- och Linux-datorerna.

Syntax

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

Description

Cmdleten Uninstall-SCXAgent avinstallerar hanteringsagenten på de angivna UNIX- och Linux-datorerna.

Den obligatoriska Agent-parametern anger de hanterade UNIX- eller Linux-datorer som ska avinstalleras och kräver ett UNIX- eller Linux-datorobjekt. Information om hur du hämtar hanterade UNIX- eller Linux-datorer finns i cmdleten Get-SCXAgent. En valfri SSHCredential- parameter kan anges för att identifiera de privilegierade autentiseringsuppgifter som används för avinstallation av hanteringsagenten. Om SSHCredential- inte har angetts försöker cmdleten använda det definierade privilegierade Kör som-kontot för agenten.

Den här cmdleten returnerar inga utdata.

Exempel

Exempel 1: Avinstallera en hanteringsagent

PS C:\>$Agent01 = Get-SCXAgent -Name "nx1.contoso.com"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key "C:\keys\key21.ppk" -ElevationType sudo
PS C:\> Uninstall-SCXAgent -SSHCredential $SSHCredential -Agent $Agent01

Det första kommandot hämtar agenten för en hanterad Linux- eller UNIX-dator med namnet nx1.contoso.com med hjälp av cmdleten Get-SCXAgent. Kommandot lagrar det i variabeln $Agent 01.

Det andra kommandot skapar en privilegierad autentiseringsuppgift för en användare med hjälp av cmdleten Get-SCXSSHCredential. Kommandot lagrar resultatet i variabeln $SSHCredential.

Det sista kommandot avinstallerar hanteringsagenten i $Agent 01 med hjälp av en angiven SSH-autentiseringsuppgift.

Exempel 2: Avinstallera en hanteringsagent med det definierade Kör som-kontot

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

Det här kommandot hämtar agenten för en hanterad Linux- eller UNIX-dator med namnet nx1.contoso.com med hjälp av Get-SCXAgent. Kommandot skickar den hanterade datorn till den aktuella cmdleten. Kommandot avinstallerar hanteringsagenten med det definierade Kör som-kontot.

Parametrar

-Agent

Anger ett eller flera hanterade UNIX- eller Linux-datorobjekt. Om du vill ha information om hur du hämtar ett hanterat UNIX- eller Linux-datorobjekt skriver du Get-Help Get-SCXAgent.

Typ:IPersistedUnixComputer[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ComputerName

Anger en matris med namn på datorer. Cmdleten upprättar tillfälliga anslutningar med hanteringsgrupper för dessa datorer. Du kan använda NetBIOS-namn, IP-adresser eller fullständigt kvalificerade domännamn (FQDN). Om du vill ange den lokala datorn skriver du datornamnet, localhost eller en punkt (.).

System Center Data Access-tjänsten måste vara aktiv på datorn. Om du inte anger någon dator använder cmdleten datorn för den aktuella hanteringsgruppens anslutning.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Anger det användarkonto under vilket anslutningen till hanteringsgruppen körs. Ange ett PSCredential- objekt, till exempel ett objekt som cmdleten Get-Credential returnerar för den här parametern. Om du vill ha mer information om autentiseringsobjekt skriver du Get-Help Get-Credential.

Om du anger en dator i parametern ComputerName använder du ett konto som har åtkomst till datorn. Standardvärdet är den aktuella användaren.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SCSession

Anger en matris med Anslutning objekt. Om du vill hämta anslutningsobjekt använder du cmdleten Get-SCOMManagementGroupConnection.

Om den här parametern inte anges använder cmdleten den aktiva beständiga anslutningen till en hanteringsgrupp. Använd parametern SCSession för att ange en annan beständig anslutning. Du kan skapa en tillfällig anslutning till en hanteringsgrupp med hjälp av parametrarna ComputerName och Credential. Om du vill ha mer information skriver du Get-Help about_OpsMgr_Connections.

Typ:Connection[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SshCredential

Anger en privilegierad SSH-autentiseringsuppgift som används för att utföra agentunderhållsåtgärderna. Om den här parametern inte anges försöker cmdleten använda det definierade kör som-kontot för agentunderhåll för agenten.

Om du vill ha information om hur du hämtar ett SSH-autentiseringsobjekt skriver du Get-Help Get-SCXSSHCredential.

Typ:CredentialSet
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Utdata

Den här cmdleten returnerar resultat som representerar avinstallationsstatusen för en dator. Resultatet innehåller följande information:

  • Värdnamn
  • Avinstallera status
  • Beskrivning

Beskrivningen innehåller information om varför en avinstallation misslyckades.