Freigeben über

Get-SCOMLocation

  • Referenz
Modul:
OperationsManager

Ruft Speicherorte ab.

Syntax

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

Beschreibung

Das cmdlet Get-SCOMLocation ruft Speicherorte ab. Geben Sie Speicherorte an, die nach Anzeigename oder ID abgerufen werden sollen, oder indem Sie zugeordnete Agents, Verwaltungsserver oder Ressourcenpools angeben.

Sie können einen Speicherort mithilfe des Cmdlets New-SCOMLocation erstellen.

Standardmäßig verwendet dieses Cmdlet die aktive dauerhafte Verbindung zu einer Verwaltungsgruppe. Verwenden Sie den SCSession--Parameter, um eine andere dauerhafte Verbindung anzugeben. Sie können eine temporäre Verbindung mit einer Verwaltungsgruppe erstellen, indem Sie die Parameter ComputerName und Anmeldeinformationen verwenden. Geben Sie Get-Help about_OpsMgr_Connectionsein, um weitere Informationen zu erfahren.

Beispiele

Beispiel 1: Abrufen eines Speicherorts nach Anzeigename

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

Dieser Befehl ruft den Speicherort ab, der den Anzeigenamen Seattle, WA hat.

Beispiel 2: Abrufen des Speicherorts eines vom Agent verwalteten Computers

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

In diesem Beispiel wird ein Speicherort für einen vom Agent verwalteten Computer angezeigt. Der erste Befehl ruft das Agentobjekt für einen vom Agent verwalteten Computer mit dem Namen Server01.Contoso.com ab und speichert das Objekt dann in der $Agent Variablen.

Der zweite Befehl ruft den Speicherort für das Agentobjekt ab, das in der variablen $Agent gespeichert ist.

Beispiel 3: Abrufen des Speicherorts eines Verwaltungsservers

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

In diesem Beispiel wird der Speicherort für einen Verwaltungsserver mit dem Namen MgmtServer01.Contoso.com abgerufen. Der erste Befehl ruft das Verwaltungsserverobjekt für den Verwaltungsserver mit dem Namen MgmtServer01.Contoso.com ab und speichert das Objekt dann in der $MgmtSvr Variablen.

Der zweite Befehl ruft den Speicherort für das Verwaltungsserverobjekt ab, das in der variablen $MgmtSvr gespeichert ist.

Beispiel 4: Abrufen des Speicherorts eines Ressourcenpools

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

In diesem Beispiel wird ein Speicherort für den Ressourcenpool mit dem Namen Pool01 angezeigt. Der erste Befehl ruft das Ressourcenpoolobjekt für den Ressourcenpool mit dem Namen Pool01 ab und speichert das Objekt in der $Pool Variablen.

Der zweite Befehl ruft den Speicherort für den pool ab, der in der variablen $Pool gespeichert ist.

Parameter

-Agent

Gibt ein Array von AgentManagedComputer- -Objekten an. Um ein AgentManagedComputer--Objekt abzurufen, verwenden Sie das Cmdlet Get-SCOMAgent.

Typ:AgentManagedComputer[]
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ComputerName

Gibt ein Array von Namen von Computern an. Das Cmdlet richtet temporäre Verbindungen mit Verwaltungsgruppen für diese Computer ein. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Um den lokalen Computer anzugeben, geben Sie den Computernamen, den 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.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Credential

Gibt ein PSCredential- -Objekt für die Verwaltungsgruppenverbindung an. Um ein PSCredential-Objekt abzurufen, verwenden Sie das Cmdlet Get-Credential. Geben Sie Get-Help Get-Credentialein, um weitere Informationen zu erfahren.

Wenn Sie einen Computer im parameter ComputerName angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Die Standardeinstellung ist der aktuelle Benutzer.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisplayName

Gibt ein Array von Anzeigenamen an. Die Werte für diesen Parameter hängen davon ab, welche lokalisierten Management Packs Sie importieren, und vom Gebietsschema des Benutzers, der Windows PowerShell ausführt.

Typ:String[]
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Id

Gibt ein Array eindeutiger IDs von Speicherorten an.

Typ:Guid[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ManagementServer

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

Typ:ManagementServer[]
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Pool

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

Typ:ManagementServicePool[]
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SCSession

Gibt ein Array von Connection -Objekten an. Um ein Connection-Objekt abzurufen, verwenden Sie das Cmdlet Get-SCOMManagementGroupConnection.

Typ:Connection[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False