Remove-SCOMLocation
Hiermee verwijdert u koppelingen met een locatie of verwijdert u een locatie.
Syntaxis
FromAgent (Standaard)
Remove-SCOMLocation
[-Agent] <AgentManagedComputer[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromManagementServer
Remove-SCOMLocation
[-ManagementServer] <ManagementServer[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromPool
Remove-SCOMLocation
[-Pool] <ManagementServicePool[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromLocation
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.
Parametereigenschappen
| Type: | AgentManagedComputer[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
FromAgent
| Position: | 1 |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | 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.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Confirm
U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Cf |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | 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.
Parametereigenschappen
| Type: | PSCredential |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Location
Hiermee geeft u een matrix van locaties op als EnterpriseManagementObject objecten. Gebruik de cmdlet Get-SCOMLocation om een locatie te verkrijgen.
Parametereigenschappen
| Type: | EnterpriseManagementObject[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
FromLocation
| Position: | 1 |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-ManagementServer
Hiermee geeft u een matrix van beheerserverobjecten. Als u een beheerserverobject wilt verkrijgen, gebruikt u de cmdlet Get-SCOMManagementServer.
Parametereigenschappen
| Type: | ManagementServer[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
FromManagementServer
| Position: | 1 |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Pool
Hiermee geeft u een matrix van resourcegroepobjecten. Als u een resourcegroepobject wilt ophalen, gebruikt u de cmdlet Get-SCOMResourcePool.
Parametereigenschappen
| Type: | ManagementServicePool[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
FromPool
| Position: | 1 |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-SCSession
Hiermee geeft u een matrix van Connection-objecten. Als u een Connection-object wilt verkrijgen, gebruikt u de cmdlet Get-SCOMManagementGroupConnection.
Parametereigenschappen
| Type: | Connection[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-WhatIf
Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Wi |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.