Set-SCOMLocation

  • Referencia
Módulo:
OperationsManager

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

Sintaxis

Set-SCOMLocation
   [-Agent] <AgentManagedComputer[]>
   -Location <EnterpriseManagementObject>
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SCOMLocation
   [-ManagementServer] <ManagementServer[]>
   -Location <EnterpriseManagementObject>
   [-PassThru]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
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.

Tipo:AgentManagedComputer[]
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Location

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

Tipo:EnterpriseManagementObject
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:ManagementServer[]
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Pool

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

Tipo:ManagementServicePool[]
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-SCSession

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

Tipo:Connection[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False