Dela via

Uninstall-SCOMAgent

  • Referens
Modul:
OperationsManager

Avinstallerar agenter från agenthanterade datorer.

Syntax

Uninstall-SCOMAgent
         [-ActionAccount <PSCredential>]
         -Agent <AgentManagedComputer[]>
         [-PassThru]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]

Description

Cmdleten Uninstall-SCOMAgent avinstallerar agenter från agenthanterade datorer. Innan du avinstallerar en agent måste du ta bort AD DS-agenttilldelningarna (Active Directory Domain Services) från hanteringsgruppen. Du kan använda Remove-SCOMADAgentAssignment cmdet för att ta bort AD DS-agenttilldelningar från hanteringsgruppen.

Exempel

Exempel 1: Avinstallera en agent

PS C:\>Get-SCOMAgent -DNSHostName "server01.contoso.com" | Uninstall-SCOMAgent

Det första kommandot hämtar Operations Manager-agentobjektet med namnet server01.contoso.com och skickar det till cmdleten Uninstall-SCOMAgent med hjälp av pipelineoperatorn. Det andra kommandot avinstallerar agenten med namnet server01.contoso.com.

Exempel 2: Avinstallera en agent med hjälp av en objektvariabel

PS C:\>$Agent = Get-SCOMAgent -DNSHostName "server01.contoso.com"
PS C:\> Uninstall-SCOMAgent -Agent $Agent

Det här exemplet avinstallerar Operations Manager-agenten på en agenthanterad dator.

Det första kommandot hämtar det agenthanterade datorobjektet med namnet server01.contoso.com och lagrar objektet i variabeln $Agent.

Det andra kommandot avinstallerar agenten som lagras i $Agent.

Exempel 3: Avinstallera en agent med hjälp av ett åtgärdskonto

PS C:\>$Agent = Get-SCOMAgent -DNSHostName "server01.contoso.com"
PS C:\> Uninstall-SCOMAgent -Agent $Agent -ActionAccount (Get-Credential)

Det här exemplet avinstallerar Operations Manager-agenten på en agenthanterad dator när användaren har angett de autentiseringsuppgifter som Operations Manager kräver för att avinstallera agenten.

Det första kommandot hämtar agentobjektet med namnet server01.contoso.com och lagrar objektet i variabeln $Agent.

Det andra kommandot uppmanar användaren att ange de autentiseringsuppgifter som Operations Manager använder för att avinstallera en agent. Kommandot avinstallerar sedan agenten som lagras i $Agent.

Parametrar

-ActionAccount

Anger ett PSCredential- objekt. Den här parametern anger de autentiseringsuppgifter som Operations Manager använder för att köra distributionsaktiviteten. Om du inte anger den här parametern eller om du anger ett null-värde använder Operations Manager standardåtgärdskontot för hanteringsservern för agenten.

Om du vill hämta ett PSCredential--objekt använder du cmdleten Get-Credential. Om du vill ha mer information skriver du Get-Help Get-Credential.

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

-Agent

Anger en matris med AgentManagedComputer objekt. Den här parametern anger vilka Operations Manager-agenter som ska avinstalleras. Om du vill hämta ett AgentManagedComputer-objekt använder du cmdleten Get-SCOMADAgent.

Typ:AgentManagedComputer[]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
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

-PassThru

Anger att cmdleten skapar eller ändrar ett objekt som ett kommando kan använda i pipelinen. Som standard genererar den här cmdleten inga utdata.

Typ:SwitchParameter
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

Indata

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer

Utdata

Microsoft.EnterpriseManagement.Administration.AgentTaskResult