Remove-SCOMLocation

Referenz

Modul:: OperationsManager

Entfernt Zuordnungen mit einem Speicherort oder löscht einen Speicherort.

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>]

Beschreibung

Das Cmdlet Remove-SCOMLocation entfernt die Zuordnung eines Speicherorts mit einem agent-verwalteten Computer, Verwaltungsserver oder Ressourcenpool, oder es löscht einen Speicherort. Wenn Sie eine Zuordnung entfernen möchten, geben Sie verwaltete Computer, Verwaltungsserver oder Ressourcenpools an. Um einen Speicherort zu löschen, geben Sie den Speicherort mithilfe des Cmdlets Get-SCOMLocation an.

Mithilfe des Cmdlets Update-SCOMLocation können Sie einen Speicherortanzeigenamen, einen Breitengrad oder einen Längengrad ändern.

Standardmäßig verwendet dieses Cmdlet die aktive persistente Verbindung zu einer Verwaltungsgruppe. Verwenden Sie den SCSession-Parameter , um eine andere persistente Verbindung anzugeben. Sie können eine temporäre Verbindung zu einer Verwaltungsgruppe erstellen, indem Sie die Parameter "ComputerName " und "Anmeldeinformationen " verwenden. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help about_OpsMgr_Connections.

Beispiele

Beispiel 1: Löschen eines Speicherorts

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

In diesem Beispiel wird ein Speicherort gelöscht, der den Anzeigenamen Seattle, WA hat. Der erste Befehl ruft das Speicherortobjekt ab, das den Anzeigenamen Seattle, WA aufweist und dann das Objekt in der $Location Variable speichert.

Der zweite Befehl löscht das Speicherortobjekt, das in der $Location Variablen gespeichert ist.

Beispiel 2: Entfernen eines verwalteten Agentcomputers an einem Speicherort

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

In diesem Beispiel wird ein vom Agent verwalteter Computer mit dem Namen "Server73.Contoso.com" aus seinem Speicherort entfernt. Der erste Befehl ruft das Agentobjekt für den Computer namens Server73.Contoso.com ab und speichert dann das Objekt in der $Agent Variablen.

Der zweite Befehl entfernt die Standortzuordnung aus dem im $Agent Variablen gespeicherten Agent-Computerobjekt. Dieser Befehl löscht den Speicherort nicht selbst.

Beispiel 3: Entfernen eines Verwaltungsservers an einem Speicherort

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

In diesem Beispiel wird ein Verwaltungsserver aus seinem Speicherort entfernt. Der erste Befehl ruft das Verwaltungsserverobjekt namens MgmtServer01.Contoso.com ab, und speichert dann das Objekt in der $MgmtServer Variablen.

Der zweite Befehl entfernt die Standortzuordnung aus dem Verwaltungsserverobjekt, das in der $MgmtServer Variable gespeichert ist. Dieser Befehl löscht den Speicherort nicht selbst.

Beispiel 4: Entfernen eines Ressourcenpools aus einem Speicherort

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

In diesem Beispiel wird ein Ressourcenpool mit dem Namen "Notification Resource Pool" aus seinem Speicherort entfernt. Der erste Befehl ruft das Ressourcenpoolobjekt für einen Ressourcenpool namens "Notification Resource Pool" ab und speichert dann das Objekt in der $Pool Variablen.

Der zweite Befehl entfernt die Standortzuordnung aus dem Ressourcenpoolobjekt, das in der $Pool Variable gespeichert ist. Dieser Befehl löscht den Speicherort nicht selbst.

Parameter

-Agent

Gibt ein Array von AgentManagedComputer-Objekten an. Verwenden Sie zum Abrufen eines AgentManagedComputer-Objekts das Cmdlet Get-SCOMAgent .

Type:	AgentManagedComputer[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ComputerName

Gibt ein Array von Namen von Computern an. Das Cmdlet erstellt temporäre Verbindungen mit Verwaltungsgruppen für diese Computer. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Geben Sie zum Angeben des lokalen Computers den Computernamen, localhost oder einen Punkt (.) ein.

Der System Center Data Access-Dienst muss auf dem Computer ausgeführt werden. Wenn Sie keinen Computer angeben, verwendet das Cmdlet den Computer für die aktuelle Verwaltungsgruppenverbindung.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Gibt ein PSCredential-Objekt für die Verwaltungsgruppenverbindung an. Verwenden Sie zum Abrufen eines PSCredential-Objekts das Get-Credential-Cmdlet. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential.

Wenn Sie einen Computer im ComputerName-Parameter angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Der Standardwert ist der aktuelle Benutzer.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

Gibt ein Array von Speicherorten als EnterpriseManagementObject-Objekte an. Verwenden Sie zum Abrufen eines Speicherorts das Cmdlet "Get-SCOMLocation ".

Type:	EnterpriseManagementObject[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ManagementServer

Gibt ein Array von Verwaltungsserverobjekten an. Verwenden Sie zum Abrufen eines Verwaltungsserverobjekts das Cmdlet Get-SCOMManagementServer .

Type:	ManagementServer[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Pool

Gibt ein Array von Ressourcenpoolobjekten an. Verwenden Sie zum Abrufen eines Ressourcenpoolobjekts das Cmdlet Get-SCOMResourcePool .

Type:	ManagementServicePool[]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SCSession

Gibt ein Array von Connection-Objekten an. Verwenden Sie zum Abrufen eines Connection-Objekts das Cmdlet Get-SCOMManagementGroupConnection.

Type:	Connection[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False