Remove-SCOMLocation

Referencia

Módulo:: OperationsManager

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

Syntax

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 los parámetros ComputerName y Credential . Para obtener más información, escriba Get-Help about_OpsMgr_Connections.

Ejemplos

Ejemplo 1: Eliminación de 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 de 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 de 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 de 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 Notifications Resource Pool (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 de 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 .

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

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
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

-Location

Especifica una matriz de ubicaciones como objetos EnterpriseManagementObject . Para obtener una ubicación, use el cmdlet Get-SCOMLocation .

Type:	EnterpriseManagementObject[]
Position:	1
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

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False