Compartir a través de

Remove-SCOMLocation

  • Referencia
Módulo:
OperationsManager

Quita las asociaciones con una ubicación o elimina una ubicación.

Sintaxis

Remove-SCOMLocation
      [-Agent] <AgentManagedComputer[]>
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-SCOMLocation
      [-ManagementServer] <ManagementServer[]>
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-SCOMLocation
      [-Pool] <ManagementServicePool[]>
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-SCOMLocation
      [-Location] <EnterpriseManagementObject[]>
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El cmdlet Remove-SCOMLocation quita la asociación de una ubicación con un equipo administrado por agente, un servidor de administración o un grupo de recursos, o elimina una ubicación. Para quitar una asociación, especifique equipos administrados por agente, servidores de administración o grupos de recursos. Para eliminar una ubicación, especifique la ubicación mediante el cmdlet get-SCOMLocation .

Puede cambiar un nombre para mostrar de ubicación, una latitud o una longitud mediante el cmdlet Update-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: Eliminar una ubicación

PS C:\>$Location = Get-SCOMLocation -DisplayName "Seattle, WA"
PS C:\> Remove-SCOMLocation -Location $Location

En este ejemplo se elimina una ubicación que tiene el nombre para mostrar Seattle, WA. El primer comando obtiene el objeto location que tiene el nombre para mostrar Seattle, WA y, a continuación, almacena el objeto en la variable $Location.

El segundo comando elimina el objeto location almacenado en la variable $Location.

Ejemplo 2: Eliminación de un equipo administrado por agente de una ubicación

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

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

El segundo comando quita la asociación de ubicación del objeto de equipo administrado por el agente almacenado en la variable $Agent. Este comando no elimina la propia ubicación.

Ejemplo 3: Quitar un servidor de administración de una ubicación

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

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

El segundo comando quita la asociación de ubicación del objeto del servidor de administración almacenado en la variable $MgmtServer. Este comando no elimina la propia ubicación.

Ejemplo 4: Quitar un grupo de recursos de una ubicación

PS C:\>$Pool = Get-SCOMResourcePool -Name "Notifications Resource Pool"
PS C:\> Remove-SCOMLocation -Pool $Pool

En este ejemplo se quita un grupo de recursos denominado Grupo de recursos de notificaciones de su ubicación. El primer comando obtiene el objeto de grupo de recursos de un grupo de recursos denominado Grupo de recursos de notificaciones y, a continuación, almacena el objeto en la variable $Pool.

El segundo comando quita la asociación de ubicación del objeto del grupo de recursos almacenado en la variable $Pool. Este comando no elimina la propia ubicació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 matriz de ubicaciones como objetos EnterpriseManagementObject. Para obtener una ubicación, use el cmdlet Get-SCOMLocation.

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

-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