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 mithilfe der Parameter "ComputerName " und "Anmeldeinformationen " erstellen. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help about_OpsMgr_Connections.

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 $Agent Variablen 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 namens 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 namens "Pool01" angezeigt. Der erste Befehl ruft das Ressourcenpoolobjekt für den Ressourcenpool namens Pool01 ab und speichert das Objekt in der $Pool Variablen.

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

Parameter

-Agent

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

Type:AgentManagedComputer[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Gibt ein PSCredential-Objekt für die Verwaltungsgruppenverbindung an. Verwenden Sie zum Abrufen eines PSCredential-Objekts das Get-Credential-Cmdlet. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential.

Wenn Sie einen Computer im ComputerName-Parameter angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Der Standardwert ist der aktuelle Benutzer.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

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

Type:String[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Id

Gibt ein Array eindeutiger IDs von Speicherorten an.

Type:Guid[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ManagementServer

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

Type:ManagementServer[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Pool

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

Type:ManagementServicePool[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SCSession

Gibt ein Array von Connection-Objekten an. Verwenden Sie zum Abrufen eines Connection-Objekts das Cmdlet Get-SCOMManagementGroupConnection.

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False