Remove-SCOMLocation
Remove associações com um local ou exclui um local.
Sintaxe
FromAgent (Padrão)
Remove-SCOMLocation
[-Agent] <AgentManagedComputer[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromManagementServer
Remove-SCOMLocation
[-ManagementServer] <ManagementServer[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromPool
Remove-SCOMLocation
[-Pool] <ManagementServicePool[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
FromLocation
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 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.
Propriedades do parâmetro
| Tipo: | AgentManagedComputer[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
FromAgent
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Credential
Especifica um objeto PSCredential 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.
Propriedades do parâmetro
| Tipo: | PSCredential |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Location
Especifica uma matriz de locais como objetos EnterpriseManagementObject. Para obter um local, use o cmdlet Get-SCOMLocation.
Propriedades do parâmetro
| Tipo: | EnterpriseManagementObject[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
FromLocation
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ManagementServer
Especifica uma matriz de objetos do servidor de gerenciamento. Para obter um objeto de servidor de gerenciamento, use o cmdlet Get-SCOMManagementServer.
Propriedades do parâmetro
| Tipo: | ManagementServer[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
FromManagementServer
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Pool
Especifica uma matriz de objetos do pool de recursos.
Para obter um objeto de pool de recursos, use o cmdlet Get-SCOMResourcePool
Propriedades do parâmetro
| Tipo: | ManagementServicePool[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
FromPool
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SCSession
Especifica uma matriz de objetos Connection.
Para obter um objeto
Propriedades do parâmetro
| Tipo: | Connection[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.