Compartir a través de

Set-SCOMLocation

Módulo:
OperationsManager Module

Asocia equipos administrados por agente, servidores de administración o grupos de recursos a una ubicación.

Sintaxis

FromAgent (Es el valor predeterminado). 

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

FromManagementServer 

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

FromPool 

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

Description

El cmdlet Set-SCOMLocation asocia uno o varios equipos administrados por agente, servidores de administración o grupos de recursos con una ubicación. Este cmdlet quita una asociación actual, si existe una. El panel de mapa de resumen de supervisión de disponibilidad de aplicaciones web muestra información de estado para agentes, servidores de administración y grupos de recursos asociados a una ubicación.

Puede quitar una asociación mediante el cmdlet remove-SCOMLocation . Puede crear una ubicación mediante el cmdlet new-SCOMLocation de 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 el computerName de y parámetros de Credential. Para obtener más información, escriba Get-Help about_OpsMgr_Connections.

Ejemplos

Ejemplo 1: Asociar un agente a una ubicación

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

En este ejemplo se asocia un equipo administrado por agente denominado Sever01.Contoso.com con la ubicación Seattle, WA. El primer comando obtiene el objeto location que tiene el nombre para mostrar de Seattle, WA y, a continuación, almacena el objeto en la variable $Location.

El segundo comando obtiene el objeto del agente denominado Server01.Contoso.com y, a continuación, almacena el objeto en la variable $Agent.

El tercer comando asocia la ubicación almacenada en la variable $Location con el equipo administrado por el agente almacenado en la variable $Agent. Si anteriormente asociaba este equipo administrado por agente con una ubicación, el comando quita esa asociación.

Ejemplo 2: Asociar un servidor de administración a una ubicación

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

En este ejemplo se asocia un servidor de administración denominado MgmtServer01.Contoso.com a la ubicación Nueva York, NY. El primer comando obtiene el objeto location que tiene el nombre para mostrar de New York, NY y, a continuación, almacena el objeto en la variable $Location.

El segundo comando obtiene el objeto de servidor de administración denominado MgmtServer01.Contoso.com y almacena el objeto en la variable $MgmtServer.

El tercer comando asocia la ubicación almacenada en la variable $Location con el servidor de administración almacenado en la variable $MgmtServer. Si anteriormente asociaba este servidor de administración con una ubicación, el comando quita esa asociación.

Ejemplo 3: Asociar un grupo de recursos a una ubicación

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

En este ejemplo se asocia un grupo de recursos denominado Grupo de recursos de notificaciones con la ubicación París, FR. El primer comando obtiene el objeto location que tiene el nombre para mostrar Paris, FR y, a continuación, almacena el objeto en la variable $Location.

El segundo comando obtiene el grupo de recursos denominado Grupo de recursos de notificaciones y, a continuación, almacena el objeto en la variable $Pool.

El tercer comando asocia la ubicación almacenada en la variable $Location con el grupo de recursos almacenado en la variable $Pool. Si anteriormente asociaba el grupo de recursos con una ubicación, el comando quita esa asociación.

Parámetros

-Agent

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

Propiedades del parámetro

Tipo:

AgentManagedComputer[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

FromAgent
Posición:1
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Credential

Especifica un objeto de PSCredential para la conexión del grupo de administración. Para obtener un objeto de de PSCredential, use el cmdlet get-credential de . 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.

Propiedades del parámetro

Tipo:PSCredential
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Location

Especifica una ubicación como un objeto EnterpriseManagementObject. Para obtener una ubicación, use el cmdlet Get-SCOMLocation.

Propiedades del parámetro

Tipo:EnterpriseManagementObject
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes: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.

Propiedades del parámetro

Tipo:

ManagementServer[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

FromManagementServer
Posición:1
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-PassThru

Indica que el cmdlet crea o modifica un objeto que un comando puede usar en la canalización. De forma predeterminada, este cmdlet no genera ninguna salida.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Pool

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

Propiedades del parámetro

Tipo:

ManagementServicePool[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

FromPool
Posición:1
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SCSession

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

Propiedades del parámetro

Tipo:

Connection[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.