Compartilhar via

Remove-SCOMLocation

  • Referência
Módulo:
OperationsManager

Remove associações com um local ou exclui um local.

Sintaxe

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 gerenciado por agente, servidor de gerenciamento ou pool de recursos ou exclui um local. Para remover uma associação, especifique computadores gerenciados por agente, servidores de gerenciamento ou pools de recursos. Para excluir um local, especifique o local usando o cmdlet Get-SCOMLocation .

Você pode alterar um nome de exibição de local, uma latitude ou uma longitude usando o cmdlet Update-SCOMLocation.

Por padrão, esse cmdlet usa a conexão persistente ativa com um grupo de gerenciamento. Use o parâmetro SCSession para especificar uma conexão persistente diferente. Você pode criar uma conexão temporária com um grupo de gerenciamento usando os parâmetros ComputerName e Credential. Para obter mais informações, digite Get-Help about_OpsMgr_Connections.

Exemplos

Exemplo 1: excluir um local

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

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

O segundo comando exclui o objeto de local armazenado na variável $Location.

Exemplo 2: remover um computador gerenciado por agente de um local

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

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

O segundo comando remove a associação de localização do objeto de computador gerenciado pelo agente armazenado na variável $Agent. Esse comando não exclui o local em si.

Exemplo 3: remover um servidor de gerenciamento de um local

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

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

O segundo comando remove a associação de localização do objeto do servidor de gerenciamento armazenado na variável $MgmtServer. Esse comando não exclui o local em si.

Exemplo 4: remover um pool de recursos de um local

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

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

O segundo comando remove a associação de localização do objeto do pool de recursos armazenado na variável $Pool. Esse comando não exclui o local em si.

Parâmetros

-Agent

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

Tipo:AgentManagedComputer[]
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ComputerName

Especifica uma matriz de nomes de computadores. O cmdlet estabelece conexões temporárias com grupos de gerenciamento para esses computadores. Você pode usar nomes NetBIOS, endereços IP ou FQDNs (nomes de domínio totalmente qualificados). Para especificar o computador local, digite o nome do computador, localhost ou um ponto (.).

O serviço de Acesso a Dados do System Center deve estar em execução no computador. Se você não especificar um computador, o cmdlet usará o computador para a conexão do grupo de gerenciamento atual.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Credential

Especifica um objeto PSCredential para a conexão do grupo de gerenciamento. Para obter um objeto PSCredential, use o cmdlet Get-Credential. Para obter mais informações, digite Get-Help Get-Credential.

Se você especificar um computador no parâmetro ComputerName, use uma conta que tenha acesso a esse computador. O padrão é o usuário atual.

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Location

Especifica uma matriz de locais como objetos EnterpriseManagementObject. Para obter um local, use o cmdlet Get-SCOMLocation.

Tipo:EnterpriseManagementObject[]
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ManagementServer

Especifica uma matriz de objetos do servidor de gerenciamento. Para obter um objeto de servidor de gerenciamento, use o cmdlet Get-SCOMManagementServer.

Tipo:ManagementServer[]
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Pool

Especifica uma matriz de objetos do pool de recursos. Para obter um objeto de pool de recursos, use o cmdlet Get-SCOMResourcePool .

Tipo:ManagementServicePool[]
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SCSession

Especifica uma matriz de objetos Connection. Para obter um objeto Connection, use o cmdlet Get-SCOMManagementGroupConnection .

Tipo:Connection[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False