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 agentparametern anger vilka 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 anges försöker cmdleten använda det definierade privilegierade Kör som-kontot för agenten.

Denna cmdlet 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 hanteringsgruppanslutningen.

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. Standard ä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 anslutningsobjekt . 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 SCSession-parametern 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 . För mer information ange 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ördes. 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
Avinstallationsstatus
Beskrivning

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

Dela via