Dela via

Remove-SCOMLocation

  • Referens
Modul:
OperationsManager

Tar bort associationer med en plats eller tar bort en plats.

Syntax

Remove-SCOMLocation
      [-Agent] <AgentManagedComputer[]>
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-SCOMLocation
      [-ManagementServer] <ManagementServer[]>
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-SCOMLocation
      [-Pool] <ManagementServicePool[]>
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-SCOMLocation
      [-Location] <EnterpriseManagementObject[]>
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Cmdleten Remove-SCOMLocation tar bort associationen för en plats med en agenthanterad dator, hanteringsserver eller resurspool, eller så tas en plats bort. Om du vill ta bort en association anger du agenthanterade datorer, hanteringsservrar eller resurspooler. Om du vill ta bort en plats anger du platsen med hjälp av cmdleten Get-SCOMLocation.

Du kan ändra ett platsvisningsnamn, en latitud eller en longitud med hjälp av cmdleten Update-SCOMLocation.

Som standard använder den här 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.

Exempel

Exempel 1: Ta bort en plats

PS C:\>$Location = Get-SCOMLocation -DisplayName "Seattle, WA"
PS C:\> Remove-SCOMLocation -Location $Location

Det här exemplet tar bort en plats som har visningsnamnet Seattle, WA. Det första kommandot hämtar platsobjektet som har visningsnamnet Seattle, WA och lagrar sedan objektet i variabeln $Location.

Det andra kommandot tar bort platsobjektet som lagras i variabeln $Location.

Exempel 2: Ta bort en agenthanterad dator från en plats

PS C:\>$Agent = Get-SCOMAgent -Name "Server73.Contoso.com"
PS C:\> Remove-SCOMLocation -Agent $Agent

Det här exemplet tar bort en agenthanterad dator med namnet Server73.Contoso.com från dess plats. Det första kommandot hämtar agentobjektet för datorn med namnet Server73.Contoso.com och lagrar sedan objektet i variabeln $Agent.

Det andra kommandot tar bort platsassociationen från det agenthanterade datorobjektet som lagras i variabeln $Agent. Det här kommandot tar inte bort själva platsen.

Exempel 3: Ta bort en hanteringsserver från en plats

PS C:\>$MgmtServer = Get-SCOMManagementServer -Name "MgmtServer01.Contoso.com"
PS C:\> Remove-SCOMLocation -ManagementServer $MgmtServer

Det här exemplet tar bort en hanteringsserver från dess plats. Det första kommandot hämtar hanteringsserverobjektet med namnet MgmtServer01.Contoso.com och lagrar sedan objektet i variabeln $MgmtServer.

Det andra kommandot tar bort platsassociationen från hanteringsserverobjektet som lagras i variabeln $MgmtServer. Det här kommandot tar inte bort själva platsen.

Exempel 4: Ta bort en resurspool från en plats

PS C:\>$Pool = Get-SCOMResourcePool -Name "Notifications Resource Pool"
PS C:\> Remove-SCOMLocation -Pool $Pool

Det här exemplet tar bort en resurspool med namnet Notifications Resource Pool från dess plats. Det första kommandot hämtar resurspoolobjektet för en resurspool med namnet Meddelanderesurspool och lagrar sedan objektet i variabeln $Pool.

Det andra kommandot tar bort platsassociationen från resurspoolobjektet som lagras i variabeln $Pool. Det här kommandot tar inte bort själva platsen.

Parametrar

-Agent

Anger en matris med AgentManagedComputer objekt. Om du vill hämta ett AgentManagedComputer--objekt använder du cmdleten Get-SCOMAgent.

Typ:AgentManagedComputer[]
Position:1
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 köras 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 ett PSCredential- objekt för hanteringsgruppens anslutning. 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.

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

-Location

Anger en matris med platser som EnterpriseManagementObject objekt. Om du vill hämta en plats använder du cmdleten Get-SCOMLocation.

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

-ManagementServer

Anger en matris med hanteringsserverobjekt. Om du vill hämta ett hanteringsserverobjekt använder du cmdleten Get-SCOMManagementServer.

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

-Pool

Anger en matris med resurspoolobjekt. Om du vill hämta ett resurspoolobjekt använder du cmdleten Get-SCOMResourcePool.

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

-SCSession

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

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