Delen via

Remove-SCOMLocation

  • Referentie
Module:
OperationsManager

Hiermee verwijdert u koppelingen met een locatie of verwijdert u een locatie.

Syntaxis

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

De cmdlet Remove-SCOMLocation verwijdert de koppeling van een locatie met een door agents beheerde computer, beheerserver of resourcegroep, of verwijdert een locatie. Als u een koppeling wilt verwijderen, geeft u door agents beheerde computers, beheerservers of resourcegroepen op. Als u een locatie wilt verwijderen, geeft u de locatie op met behulp van de cmdlet Get-SCOMLocation.

U kunt de weergavenaam van een locatie, een breedtegraad of lengtegraad wijzigen met behulp van de cmdlet Update-SCOMLocation.

Deze cmdlet maakt standaard gebruik van de actieve permanente verbinding met een beheergroep. Gebruik de parameter SCSession om een andere permanente verbinding op te geven. U kunt een tijdelijke verbinding met een beheergroep maken met behulp van de parameters ComputerName en Credential. Typ Get-Help about_OpsMgr_Connectionsvoor meer informatie.

Voorbeelden

Voorbeeld 1: Een locatie verwijderen

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

In dit voorbeeld wordt een locatie verwijderd met de weergavenaam Seattle, WA. Met de eerste opdracht wordt het locatieobject met de weergavenaam Seattle, WA opgehaald en wordt het object vervolgens opgeslagen in de $Location variabele.

Met de tweede opdracht wordt het locatieobject verwijderd dat is opgeslagen in de variabele $Location.

Voorbeeld 2: Een door een agent beheerde computer verwijderen van een locatie

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

In dit voorbeeld wordt een door een agent beheerde computer met de naam Server73.Contoso.com verwijderd van de locatie. Met de eerste opdracht wordt het agentobject voor de computer met de naam Server73.Contoso.com opgehaald en wordt het object vervolgens opgeslagen in de variabele $Agent.

Met de tweede opdracht wordt de locatiekoppeling verwijderd uit het door de agent beheerde computerobject dat is opgeslagen in de variabele $Agent. Met deze opdracht wordt de locatie zelf niet verwijderd.

Voorbeeld 3: Een beheerserver van een locatie verwijderen

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

In dit voorbeeld wordt een beheerserver van de locatie verwijderd. Met de eerste opdracht wordt het beheerserverobject met de naam MgmtServer01.Contoso.com opgehaald en wordt het object vervolgens opgeslagen in de $MgmtServer variabele.

Met de tweede opdracht wordt de locatiekoppeling verwijderd uit het beheerserverobject dat is opgeslagen in de $MgmtServer variabele. Met deze opdracht wordt de locatie zelf niet verwijderd.

Voorbeeld 4: Een resourcegroep verwijderen van een locatie

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

In dit voorbeeld wordt een resourcegroep met de naam Notification Resource Pool verwijderd van de locatie. Met de eerste opdracht wordt het resourcegroepobject opgehaald voor een resourcegroep met de naam Notification Resource Pool en slaat het object vervolgens op in de $Pool variabele.

Met de tweede opdracht wordt de locatiekoppeling verwijderd uit het resourcegroepobject dat is opgeslagen in de $Pool variabele. Met deze opdracht wordt de locatie zelf niet verwijderd.

Parameters

-Agent

Hiermee geeft u een matrix van AgentManagedComputer objecten. Als u een AgentManagedComputer-object wilt verkrijgen, gebruikt u de cmdlet Get-SCOMAgent.

Type:AgentManagedComputer[]
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ComputerName

Hiermee geeft u een matrix van namen van computers. Met de cmdlet worden tijdelijke verbindingen met beheergroepen voor deze computers tot stand gebracht. U kunt NetBIOS-namen, IP-adressen of FQDN's (Fully Qualified Domain Names) gebruiken. Als u de lokale computer wilt opgeven, typt u de computernaam, localhost of een punt (.).

De System Center Data Access-service moet worden uitgevoerd op de computer. Als u geen computer opgeeft, gebruikt de cmdlet de computer voor de huidige beheergroepverbinding.

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u een PSCredential-object voor de verbinding met de beheergroep. Als u een PSCredential--object wilt verkrijgen, gebruikt u de cmdlet Get-Credential. Typ Get-Help Get-Credentialvoor meer informatie.

Als u een computer opgeeft in de parameter ComputerName, gebruikt u een account dat toegang heeft tot die computer. De standaardwaarde is de huidige gebruiker.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Location

Hiermee geeft u een matrix van locaties op als EnterpriseManagementObject objecten. Gebruik de cmdlet Get-SCOMLocation om een locatie te verkrijgen.

Type:EnterpriseManagementObject[]
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ManagementServer

Hiermee geeft u een matrix van beheerserverobjecten. Als u een beheerserverobject wilt verkrijgen, gebruikt u de cmdlet Get-SCOMManagementServer.

Type:ManagementServer[]
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Pool

Hiermee geeft u een matrix van resourcegroepobjecten. Als u een resourcegroepobject wilt ophalen, gebruikt u de cmdlet Get-SCOMResourcePool.

Type:ManagementServicePool[]
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SCSession

Hiermee geeft u een matrix van Connection-objecten. Als u een Connection-object wilt verkrijgen, gebruikt u de cmdlet Get-SCOMManagementGroupConnection.

Type:Connection[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False