Compartilhar via

Remove-SCOMLocation

  • Referência
Módulo:
OperationsManager

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

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 gerenciado pelo 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 localização que tem o nome de exibição Seattle, WA e armazena o objeto na variável $Location.

O segundo comando exclui o objeto de localização 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 .

Type:AgentManagedComputer[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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

-Confirm

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

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

-Location

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

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

-ManagementServer

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

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

-Pool

Especifica uma matriz de objetos do pool de recursos. Para obter um objeto de pool de recursos, use 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 Connection . Para obter um objeto Connection , use o cmdlet Get-SCOMManagementGroupConnection .

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

-WhatIf

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

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