Share via

Get-SCOMLocation

  • Referencia
Módulo:
OperationsManager

Obtiene ubicaciones.

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

Description

El cmdlet Get-SCOMLocation obtiene ubicaciones. Especifique las ubicaciones que se van a obtener por nombre para mostrar o identificador, o mediante la especificación de agentes, servidores de administración o grupos de recursos asociados.

Puede crear una ubicación mediante el cmdlet New-SCOMLocation .

De forma predeterminada, este cmdlet usa la conexión persistente activa a un grupo de administración. Use el parámetro SCSession para especificar una conexión persistente diferente. Puede crear una conexión temporal a un grupo de administración mediante los parámetros ComputerName y Credential . Para obtener más información, escriba Get-Help about_OpsMgr_Connections.

Ejemplos

Ejemplo 1: Obtener una ubicación por nombre para mostrar

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

Este comando obtiene la ubicación que tiene el nombre para mostrar Seattle, WA.

Ejemplo 2: Obtención de la ubicación de un equipo administrado por agente

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

En este ejemplo se obtiene una ubicación para un equipo administrado por agente. El primer comando obtiene el objeto de agente para un equipo administrado por el agente denominado Server01.Contoso.com y, a continuación, almacena el objeto en la variable $Agent.

El segundo comando obtiene la ubicación del objeto del agente almacenado en la variable $Agent.

Ejemplo 3: Obtener la ubicación de un servidor de administración

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

En este ejemplo se obtiene la ubicación de un servidor de administración denominado MgmtServer01.Contoso.com. El primer comando obtiene el objeto del servidor de administración para el servidor de administración denominado MgmtServer01.Contoso.com y, a continuación, almacena el objeto en la variable $MgmtSvr.

El segundo comando obtiene la ubicación del objeto del servidor de administración almacenado en la variable $MgmtSvr.

Ejemplo 4: Obtención de la ubicación de un grupo de recursos

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

En este ejemplo se obtiene una ubicación para el grupo de recursos denominado Pool01. El primer comando obtiene el objeto del grupo de recursos para el grupo de recursos denominado Pool01 y almacena el objeto en la variable $Pool.

El segundo comando obtiene la ubicación del grupo almacenado en la variable $Pool.

Parámetros

-Agent

Especifica una matriz de objetos AgentManagedComputer . Para obtener un objeto AgentManagedComputer , use el cmdlet Get-SCOMAgent .

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

-ComputerName

Especifica una matriz de nombres de equipos. El cmdlet establece conexiones temporales con grupos de administración para estos equipos. Puede usar nombres netBIOS, direcciones IP o nombres de dominio completos (FQDN). Para especificar el equipo local, escriba el nombre del equipo, localhost o un punto (.).

El servicio de acceso a datos de System Center debe ejecutarse en el equipo. Si no especifica un equipo, el cmdlet usa el equipo para la conexión del grupo de administración actual.

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

-Credential

Especifica un objeto PSCredential para la conexión del grupo de administración. Para obtener un objeto PSCredential, use el cmdlet Get-Credential. Para obtener más información, escriba Get-Help Get-Credential.

Si especifica un equipo en el parámetro ComputerName , use una cuenta que tenga acceso a ese equipo. El valor predeterminado es el usuario actual.

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

-DisplayName

Especifica una matriz de nombres para mostrar. Los valores de este parámetro dependen de los módulos de administración localizados que importe y de la configuración regional del usuario que ejecuta Windows PowerShell.

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

-Id

Especifica una matriz de identificadores únicos de ubicaciones.

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

-ManagementServer

Especifica una matriz de objetos del servidor de administración. Para obtener un objeto de servidor de administración, use el cmdlet Get-SCOMManagementServer .

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

-Pool

Especifica una matriz de objetos del grupo de recursos. Para obtener un objeto de grupo de recursos, use el cmdlet Get-SCOMResourcePool .

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

-SCSession

Especifica una matriz de objetos Connection . Para obtener un objeto Connection , use el cmdlet Get-SCOMManagementGroupConnection .

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