Dela via

Remove-SCXAgent

  • Referens
Modul:
OperationsManager

Tar bort de hanterade UNIX- och Linux-datorerna från hanteringsgruppen.

Syntax

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

Description

Cmdleten Remove-SCXAgent tar bort de hanterade UNIX- och Linux-datorerna från hanteringsgruppen. Hanterade UNIX- och Linux-datorer skickas till Remove-SCXAgent cmdlet som en matris med UNIX- och Linux-datorobjekt.

Information om hur du hämtar hanterade UNIX- och Linux-datorer finns i cmdleten Get-SCXAgent.

Den här cmdleten returnerar inga utdata.

Exempel

Exempel 1: Ta bort hanteringsagenter

PS C:\>$Agents = Get-SCXAgent -Name "scxserver1.contoso.com","scxserver2*","*.development.contoso.com"
PS C:\> Remove-SCXAgent -Agent $Agents

Det första kommandot hämtar agenter för hanterade Linux- eller UNIX-datorer som matchar de angivna namnen med hjälp av cmdleten Get-SCXAgent. Kommandot lagrar resultatet i $Agents matrisvariabeln.

Det sista kommandot tar bort agenterna i $Agents.

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

PS C:\>Get-SCXAgent -Name "scxserver1.contoso.com","scxserver2*","*.development.contoso.com" | Remove-SCXAgent

Det här kommandot hämtar agenter för hanterad Linux- eller UNIX-dator som matchar de angivna namnen med hjälp av Get-SCXAgent. Kommandot skickar agenterna till den aktuella cmdleten. Kommandot tar bort hanteringsagenterna.

Parametrar

-Agent

Anger ett eller flera hanterade UNIX- och 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

-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 genererar inga utdata. Det finns inget felfall för cmdleten Remove-SCXAgent.