Partilhar via

Remove-SCOMLocation

  • Referência
Módulo:
OperationsManager

Remove associações com uma localização ou elimina uma localização.

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

O cmdlet Remove-SCOMLocation remove a associação de um local com um computador gerido por agente, servidor de gestão ou conjunto de recursos, ou elimina uma localização. Para remover uma associação, especifique computadores geridos por agentes, servidores de gestão ou piscinas de recursos. Para eliminar uma localização, especifique a localização utilizando o cmdlet Get-SCOMLocation .

Pode alterar um nome de visualização de localização, uma latitude ou uma longitude utilizando o cmdlet Update-SCOMLocation .

Por predefinição, este cmdlet utiliza a ligação persistente ativa a um grupo de gestão. Utilize o parâmetro SCSession para especificar uma ligação persistente diferente. Pode criar uma ligação temporária a um grupo de gestão utilizando os parâmetros ComputerName e Credential . Para mais informações, insira Get-Help about_OpsMgr_Connections.

Exemplos

Exemplo 1: Eliminar uma localização

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

Este exemplo elimina uma localização que tem o nome de exibição Seattle, WA. O primeiro comando obtém o objeto de localização que tem o nome de exibição Seattle, WA, e depois armazena o objeto na variável $Location.

O segundo comando elimina o objeto de localização armazenado na variável $Location.

Exemplo 2: Remover um computador gerido por um agente de um local

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

Este exemplo remove um computador gerido por um agente chamado Server73.Contoso.com da sua localização. O primeiro comando obtém o objeto do agente do computador chamado Server73.Contoso.com e, em seguida, armazena o objeto na variável $Agent.

O segundo comando remove a associação de localização do objeto de computador gerido pelo agente armazenado na variável $Agent. Este comando não apaga a localização em si.

Exemplo 3: Remover um servidor de gestão de um local

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

Este exemplo remove um servidor de gestão da sua localização. O primeiro comando obtém o objeto do servidor de gestão chamado MgmtServer01.Contoso.com e, em seguida, armazena o objeto na variável $MgmtServer.

O segundo comando remove a associação de localização do objeto do servidor de gestão armazenado na variável $MgmtServer. Este comando não apaga a localização em si.

Exemplo 4: Remover um conjunto de recursos de um local

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

Este exemplo remove um conjunto de recursos chamado Conjunto de Recursos de Notificações da sua localização. O primeiro comando obtém o objeto de conjunto de recursos para um conjunto de recursos chamado Conjunto de Recursos de Notificações e, em seguida, armazena o objeto na variável $Pool.

O segundo comando remove a associação de localização do objeto de piscina de recursos armazenado na variável $Pool. Este comando não apaga a localização em si.

Parâmetros

-Agent

Especifica uma matriz de objetos AgentManagedComputer . Para obter um objeto AgentManagedComputer , utilize o cmdlet Get-SCOMAgent .

Type:AgentManagedComputer[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Especifica uma série de nomes de computadores. O cmdlet estabelece ligações temporárias com grupos de gestão para estes computadores. Pode utilizar nomes NetBIOS, endereços IP ou nomes de domínio totalmente qualificados (FQDNs). Para especificar o computador local, digite o nome do computador, local local ou um ponto (.).

O serviço de acesso a dados do Centro de Sistemas deve estar a funcionar no computador. Se não especificar um computador, o cmdlet utiliza o computador para a ligação do grupo de gestão atual.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

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

-Credential

Especifica um objeto PSCredential para a ligação do grupo de gestão. Para obter um objeto PSCredential , utilize o cmdlet Get-Credential . Para mais informações, insira Get-Help Get-Credential.

Se especificar um computador no parâmetro ComputerName , utilize uma conta que tenha acesso a esse computador. A predefinição é o utilizador atual.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

Especifica uma série de locais como objetos EnterpriseManagementObject . Para obter uma localização, utilize o cmdlet Get-SCOMLocation .

Type:EnterpriseManagementObject[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ManagementServer

Especifica uma série de objetos do servidor de gestão. Para obter um objeto de servidor de gestão, utilize o cmdlet Get-SCOMManagementServer .

Type:ManagementServer[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Pool

Especifica uma variedade de objetos de piscina de recursos. Para obter um objeto de piscina de recursos, utilize o cmdlet Get-SCOMResourcePool .

Type:ManagementServicePool[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SCSession

Especifica uma matriz de objetos de ligação . Para obter um objeto de ligação , utilize o cmdlet Get-SCOMManagementGroupConnection .

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

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