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

O segundo comando exclui o objeto location 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 seu local. O primeiro comando obtém o objeto agente para o computador chamado Server73.Contoso.com e, em seguida, armazena o objeto na variável $Agent.

O segundo comando remove a associação location do objeto de computador gerenciado por agente armazenado na variável $Agent. Este 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 seu local. O primeiro comando obtém o objeto do servidor de gerenciamento chamado MgmtServer01.Contoso.com e, em seguida, armazena o objeto na variável $MgmtServer.

O segundo comando remove a associação de local do objeto do servidor de gerenciamento armazenado na variável $MgmtServer. Este 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 seu local. O primeiro comando obtém o objeto do pool de recursos para um pool de recursos chamado Pool de Recursos de Notificações e, em seguida, armazena o objeto na variável $Pool.

O segundo comando remove a associação location do objeto do pool de recursos armazenado na variável $Pool. Este 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[]
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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 atual do grupo de gerenciamento.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Location

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

Tipo:EnterpriseManagementObject[]
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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[]
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Pool

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

Tipo:ManagementServicePool[]
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-SCSession

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

Tipo:Connection[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False