Compartilhar via

  • Artigo

Get-CsLocationPolicy

 

Tópico modificado em: 2012-03-23

Retorna informações sobre como (ou se) o Serviço de Informações de Local do Enhanced 9-1-1 (E9-1-1) foi configurado. O serviço E9-1-1 permite a quem atender às chamadas de emergência determinar a localização geográfica do chamador.

Sintaxe

Get-CsLocationPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsLocationPolicy [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrição Detalhada

A política de local é usada para aplicar definições que são relacionadas à funcionalidade do E9-1-1. A política de localização determina se um usuário está habilitado para o E9-1-1 e, se estiver, qual será o comportamento de uma chamada de emergência. Por exemplo, é possível usar a política de local para definir o número que constitui uma chamada de emergência (911, nos Estados Unidos), se a segurança corporativa deve ser notificada automaticamente, como a chamada deve ser roteada e assim por diante. Este cmdlet recupera uma ou várias políticas de local.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsLocationPolicy localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

XdsIdentity

O identificador exclusivo da política de local que se deseja recuperar. Para recuperar a política de localização global, use o valor Global. No caso de uma política criada no escopo de site, esse valor estará no formato site:<nome do site>, onde nome do site é o nome de um site definido na implantação do Microsoft Lync Server 2010 (site:Redmond, por exemplo). No caso de uma política criada no escopo por usuário, esse valor simplesmente será o nome da política (Reno, por exemplo).

Filter

Opcional

Cadeia de caracteres

Uma cadeia de caracteres que contém caracteres curinga que irá recuperar as políticas de local com base na correspondência do valor Identity da política com a cadeia de caracteres curinga.

LocalStore

Opcional

SwitchParameter

Recupera as informações de política de localização na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Get-CsLocationPolicy retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy.

Exemplo

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

Get-CsLocationPolicy

O Exemplo 1 retorna uma coleção de todas as políticas de local em uso na organização. Isto é feito simplesmente chamando-se Get-CsLocationPolicy sem qualquer parâmetro.

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

Get-CsLocationPolicy -Identity Reno

O comando exibido no Exemplo 2 retorna apenas as políticas de local cuja Identidade for igual a Reno. Como as identidades devem ser exclusivas, este comando retornará, no máximo, uma política de local.

-------------------------- Exemplo 3 --------------------------

Get-CsLocationPolicy -Filter tag:*

O comando anterior usa o parâmetro -Filter para retornar todas as políticas de local que tiverem sido configuradas no escopo por usuário. (as políticas configuradas no escopo por usuário podem ser atribuídas diretamente aos usuários e a sites de rede.) A cadeia de caracteres curinga tag:* informa a Get-CsLocationPolicy que os dados retornados devem ser limitados às políticas de localização cuja Identidade começar pelo valor de cadeia de caracteres tag:. Embora não seja necessário especificar o prefixo tag: ao se recuperar uma determinada política, é possível usar esse prefixo para filtrar todas as políticas por usuário.

-------------------------- Exemplo 4 --------------------------

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

O Exemplo 4 retorna uma coleção de todas as políticas de localização cujos serviços de emergência aprimorados estiverem desabilitados. Para fazer isso, o comando usa primeiramente Get-CsLocationPolicy, para retornar uma coleção de todas as políticas de localização em uso na organização. Esta coleção será então canalizada para o cmdlet Where-Object. Where-Object aplicará um filtro que limita os dados retornados aos itens cuja propriedade EnhancedEmergencyServicesEnabled for igual a (-eq) False ($False).