Remove-SCOMLocation
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 |