Delen via

Set-SCOMLocation

  • Referentie
Module:
OperationsManager

Koppelt door agents beheerde computers, beheerservers of resourcegroepen aan een locatie.

Syntaxis

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

Description

De Set-SCOMLocation-cmdlet koppelt een of meer door agents beheerde computers, beheerservers of resourcegroepen aan een locatie. Met deze cmdlet wordt een huidige koppeling verwijderd, indien aanwezig. In het overzichtsoverzichtsdashboard voor webtoepassingsbewaking worden statusinformatie weergegeven voor agents, beheerservers en resourcegroepen die zijn gekoppeld aan een locatie.

U kunt een koppeling verwijderen met behulp van de cmdlet Remove-SCOMLocation. U kunt een locatie maken met behulp van de cmdlet New-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 agent koppelen aan een locatie

PS C:\>$Location = Get-SCOMLocation -DisplayName "Seattle, WA"
PS C:\> $Agent = Get-SCOMAgent -Name "Server01.Contoso.com"
PS C:\> Set-SCOMLocation -Location $Location -Agent $Agent

In dit voorbeeld wordt een door een agent beheerde computer met de naam Sever01.Contoso.com gekoppeld aan de locatie 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 agentobject met de naam Server01.Contoso.com opgehaald en wordt het object vervolgens opgeslagen in de $Agent variabele.

Met de derde opdracht wordt de locatie die is opgeslagen in de $Location variabele gekoppeld aan de door de agent beheerde computer die is opgeslagen in de variabele $Agent. Als u deze door agents beheerde computer eerder aan een locatie hebt gekoppeld, wordt die koppeling verwijderd door de opdracht.

Voorbeeld 2: Een beheerserver koppelen aan een locatie

PS C:\>$Location = Get-SCOMLocation -DisplayName "New York, NY"
PS C:\> $MgmtServer = Get-SCOMManagementServer -Name "MgmtServer01.Contoso.com"
PS C:\> Set-SCOMLocation -Location $Location -ManagementServer $MgmtServer

In dit voorbeeld wordt een beheerserver met de naam MgmtServer01.Contoso.com gekoppeld aan de locatie New York, NY. Met de eerste opdracht wordt het locatieobject met de weergavenaam New York, NY opgehaald en wordt het object vervolgens opgeslagen in de variabele $Location.

Met de tweede opdracht wordt het beheerserverobject met de naam MgmtServer01.Contoso.com opgehaald en wordt het object opgeslagen in de variabele $MgmtServer.

De derde opdracht koppelt de locatie die is opgeslagen in de $Location variabele aan de beheerserver die is opgeslagen in de $MgmtServer variabele. Als u deze beheerserver eerder aan een locatie hebt gekoppeld, verwijdert de opdracht die koppeling.

Voorbeeld 3: Een resourcegroep koppelen aan een locatie

PS C:\>$Location = Get-SCOMLocation -DisplayName "Paris, FR"
PS C:\> $Pool = Get-SCOMResourcePool -Name "Notifications Resource Pool"
PS C:\> Set-SCOMLocation -Location $Location -Pool $Pool

In dit voorbeeld wordt een resourcegroep met de naam Notification Resource Pool gekoppeld aan de locatie Parijs, FR. Met de eerste opdracht wordt het locatieobject met de weergavenaam Parijs, FR opgehaald en wordt het object vervolgens opgeslagen in de $Location variabele.

Met de tweede opdracht wordt de resourcegroep Met de naam Resourcegroep Meldingen opgehaald en wordt het object vervolgens opgeslagen in de $Pool variabele.

De derde opdracht koppelt de locatie die is opgeslagen in de $Location variabele aan de resourcegroep die is opgeslagen in de $Pool variabele. Als u de resourcegroep eerder aan een locatie hebt gekoppeld, verwijdert de opdracht die koppeling.

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 locatie op als een EnterpriseManagementObject object. Gebruik de cmdlet Get-SCOMLocation om een locatie te verkrijgen.

Type:EnterpriseManagementObject
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
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

-PassThru

Geeft aan dat de cmdlet een object maakt of wijzigt dat een opdracht in de pijplijn kan gebruiken. Deze cmdlet genereert standaard geen uitvoer.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
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