Compartir a través de

Remove-SCOMLocation

Módulo:
OperationsManager Module

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

Sintaxis

FromAgent (Es el valor predeterminado). 

Remove-SCOMLocation
    [-Agent] <AgentManagedComputer[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromManagementServer 

Remove-SCOMLocation
    [-ManagementServer] <ManagementServer[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromPool 

Remove-SCOMLocation
    [-Pool] <ManagementServicePool[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

FromLocation 

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.

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 matriz de ubicaciones como objetos 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

FromLocation
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

-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

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