Compartilhar via

  • Artigo

Remove-CsLocationPolicy

 

Tópico modificado em: 2012-03-27

Remove a diretiva de local especificada (as diretivas de local são usadas com o serviço Enhanced 9-1-1 para que os atendedores de chamadas de emergência determinem a localização geográfica do chamador com base no número do telefone ou do dispositivo usado para fazer a chamada).

Sintaxe

Remove-CsLocationPolicy -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

A diretiva de local é usada para aplicar configurações que tenham relação com a funcionalidade E9-1-1. A diretiva de local determina se um usuário está habilitado ou não para o recurso E9-1-1, e se for o caso, qual será o comportamento em uma chamada de emergência. Por exemplo, a diretiva de local pode ser usada para definir o número da chamada de emergência (911 nos Estados Unidos), se a segurança corporativa deve ser notificada automaticamente e como as chamadas devem ser roteadas. Este cmdlet remove uma diretiva de local existente.

Além de remover diretivas de local de site e por usuário, este cmdlet também pode ser usado para remover a diretiva de local global. Neste caso, entretanto, a diretiva na verdade não será removida, em vez disso, as configurações da diretiva serão simplesmente redefinidas para seus valores padrão.

Se o cmdlet for executado contra uma diretiva de local por usuário atribuída a um usuário, será preciso confirmar a exclusão.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Remove-CsLocationPolicy localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsLocationPolicy"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

XdsIdentity

O identificador único da diretiva de local que você deseja remover. Para remover a diretiva de local global (que apenas redefine essa diretiva para seus valores padrão), use um valor de Global. Para uma diretiva criada em escopo de site, esse valor estará no formato site:<nome do site>, onde nome do site é o nome de um site definido na implementação do Microsoft Lync Server 2010 (por exemplo, site:Redmond). Para uma diretiva criada em escopo por usuário, o valor será simplesmente o nome da diretiva, como Bldg30Floor3Sector1.

Force

Opcional

SwitchParameter

Especificar esses parâmetros ignora solicitações de confirmação, e a exclusão ocorrerá sem qualquer aviso. Por exemplo, se uma diretiva de local por usuário for atribuída a um ou mais usuários, uma solicitação de confirmação será exibida antes da exclusão, caso o parâmetro não seja incluído no comando.

WhatIf

Opcional

SwitchParameter

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

SwitchParameter

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy. Aceita entrada em pipeline dos objetos de diretiva de local.

Tipos de Retorno

Este cmdlet não retorna um valor ou objeto. Em vez disso, o cmdlet remove instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy.

Exemplo

-------------------------- Exemplo 1 --------------------------

Remove-CsLocationPolicy -Identity Reno

O comando mostrado no Exemplo 1 usa Remove-CsLocationPolicy para excluir a diretiva de local com identidade Reno. Quando uma diretiva por usuário é removida, os usuários ou grupos que haviam sido atribuídos a essa diretiva passam a usar automaticamente a diretiva configurada para os sites deles. Se nenhuma diretiva tiver sido configurada para esses sites, os usuários e grupos usarão a diretiva de local global.

-------------------------- Exemplo 2 --------------------------

Get-CsLocationPolicy | Where-Object {$_.EnhancedEmergencyServicesEnabled -eq $false} | Remove-CsLocationPolicy

O Exemplo 2 exclui todas as diretivas de local nas quais a propriedade EnhancedEmergencyServicesEnabled seja False (em outras palavras, ele exclui todas as diretivas de local que não permitam o E9-1-1). Para fazer isto, o comando primeiro usa Get-CsLocationPolicy para recuperar todas as diretivas de local em uso no momento na organização. Esta coleção é então canalizada para o cmdlet Where-Object, que aplica um filtro que limita os dados recuperados às diretivas nas quais a propriedade EnhancedEmergencyServicesEnabled seja igual a (-eq) False ($False). Finalmente, esta coleção filtrada é passada para Remove-CsLocationPolicy, que exclui cada diretiva na coleção.