Delen via

Get-SCOMLocation

  • Referentie
Module:
OperationsManager

Hiermee haalt u locaties op.

Syntaxis

Get-SCOMLocation
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMLocation
   [-Agent] <AgentManagedComputer[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMLocation
   [-ManagementServer] <ManagementServer[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMLocation
   [-Pool] <ManagementServicePool[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMLocation
   [-DisplayName] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMLocation
   -Id <Guid[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Description

De cmdlet Get-SCOMLocation haalt locaties op. Geef locaties op die moeten worden opgeslagen op weergavenaam of id, of door gekoppelde agents, beheerservers of resourcegroepen op te geven.

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 locatie ophalen op weergavenaam

PS C:\>Get-SCOMLocation -DisplayName "Seattle, WA"

Met deze opdracht haalt u de locatie op met de weergavenaam Seattle, WA.

Voorbeeld 2: De locatie van een door een agent beheerde computer ophalen

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

In dit voorbeeld wordt een locatie voor een door een agent beheerde computer ophaalt. Met de eerste opdracht wordt het agentobject opgehaald voor een door een agent beheerde computer met de naam Server01.Contoso.com en slaat het object vervolgens op in de variabele $Agent.

Met de tweede opdracht wordt de locatie opgehaald voor het agentobject dat is opgeslagen in de $Agent variabele.

Voorbeeld 3: De locatie van een beheerserver ophalen

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

In dit voorbeeld wordt de locatie voor een beheerserver met de naam MgmtServer01.Contoso.com. De eerste opdracht haalt het beheerserverobject op voor de beheerserver met de naam MgmtServer01.Contoso.com en slaat vervolgens het object op in de $MgmtSvr variabele.

Met de tweede opdracht wordt de locatie opgehaald voor het beheerserverobject dat is opgeslagen in de $MgmtSvr variabele.

Voorbeeld 4: De locatie van een resourcegroep ophalen

PS C:\>$Pool = Get-SCOMResourcePool -Name "Pool01"
PS C:\> Get-SCOMLocation -Pool $Pool

In dit voorbeeld wordt een locatie voor de resourcegroep met de naam Pool01 ophaalt. Met de eerste opdracht wordt het resourcegroepobject opgehaald voor de resourcegroep met de naam Pool01 en wordt het object opgeslagen in de $Pool variabele.

Met de tweede opdracht krijgt u de locatie voor de pool die is opgeslagen in de $Pool variabele.

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

-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

-DisplayName

Hiermee geeft u een matrix van weergavenamen. De waarden voor deze parameter zijn afhankelijk van de gelokaliseerde management packs die u importeert en de landinstelling van de gebruiker waarop Windows PowerShell wordt uitgevoerd.

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

-Id

Hiermee geeft u een matrix van unieke id's van locaties.

Type:Guid[]
Position:Named
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