Compartilhar via

  • Artigo

New-CsLocationPolicy

 

Tópico modificado em: 2012-03-26

Cria uma nova política de localização para uso com a identificação de local do serviço Enhanced 9-1-1 (E9-1-1) e com o local geral do cliente. O serviço E9-1-1 permite a quem atender às chamadas do 911 determinar a localização geográfica do chamador.

Sintaxe

New-CsLocationPolicy -Identity <XdsIdentity> [-ConferenceMode <Nullable>] [-ConferenceUri <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EmergencyDialMask <String>] [-EmergencyDialString <String>] [-EnhancedEmergencyServicesEnabled <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-LocationRequired <Nullable>] [-NotificationUri <String>] [-PstnUsage <String>] [-UseLocationForE911Only <Nullable>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

A política de localização é utilizada para aplicar definições relacionadas à funcionalidade do E9-1-1 e definições de localização a usuários ou contatos. 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 utilizar a política de localização 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, e como a chamada deve ser roteada. Este cmdlet cria uma nova política de localização no site ou em um escopo por usuário. (já existe uma política no escopo global.)

IMPORTANTE: A política de local se comporta de maneira diferente de outras políticas no Lync Server 2010 em relação à ordem de escopo. Em todas as outras políticas, se forem definidas no escopo por usuário, elas serão aplicadas a qualquer usuário ao qual tiverem sido concedidas. Se uma política por usuário não tiver sido concedida ao usuário, será aplicada a política do site. Se não houver políticas do site, será aplicada a política global. As políticas de localização são aplicadas da mesma forma, com uma exceção: uma política de localização por usuário também pode ser atribuída a um site da rede. (um site da rede consiste em um grupo de sub-redes). Se o usuário estiver fazendo uma chamada de emergência a partir de uma localização mapeada em um site da rede dentro da organização, será usada a política de nível de usuário atribuída àquele site da rede. Esta funcionalidade sobrescreverá uma política por usuário que tenha sido concedida àquele usuário. Se o usuário fizer a chamada de um local desconhecido ou não mapeado pela organização, será aplicado o escopo padrão da política.

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

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

XdsIdentity

Um identificador exclusivo da política de localização. Este cmdlet pode ser utilizado para criar uma nova política de localização no site ou em um escopo por usuário. (uma política global existe por padrão e não pode ser removida). No caso de uma política criada no escopo de site, esse valor deve 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. Por exemplo, site:Redmond. Qualquer valor de cadeia de caracteres, como Reno, pode ser atribuído a uma política criada no escopo por usuário.

ConferenceMode

Opcional

ConferenceModeEnum

Caso se especifique um valor para o parâmetro ConferenceUri, o parâmetro ConferenceMode determinará se a outra parte poderá participar da chamada ou somente escutá-la. Os valores disponíveis são:

- oneway: A outra parte só poderá escutar a conversa entre o chamador e o operador do Ponto de atendimento de segurança pública (PSAP).

- twoway: A terceira parte poderá escutar e participar da chamada entre o chamador e o operador PSAP.

ConferenceUri

Opcional

Cadeia de caracteres

O Identificador de recurso uniforme (URI) do SIP (neste caso, o número de telefone de um terceiro que será envolvido em qualquer chamada de emergência realizada). Por exemplo, o escritório de segurança da empresa poderia receber uma chamada quando uma chamada de emergência fosse realizada e escutá-la ou participar dessa chamada (em função do valor da propriedade ConferenceMode).

A cadeia de caracteres deve ter entre um e 256 caracteres de comprimento e deve começar com o prefixo sip:.

Description

Opcional

Cadeia de caracteres

Uma descrição detalhada desse local. Por exemplo, “Usuários corporativos de Reno”.

EmergencyDialMask

Opcional

Cadeia de caracteres

Um número chamado que será convertido no valor da propriedade EmergencyDialString. Por exemplo: se EmergencyDialMask tiver o valor "212" e EmergencyDialString tiver o valor "911", e se um usuário discar 212, a chamada será feita para 911. Isso permite que números de emergência alternativos sejam discados e a chamada seja enviada aos serviços de emergência (por exemplo: se alguém de um país/região com um número de emergência diferente tentar discar o número daquele país/região em vez do número do país/região em que está). Várias máscaras de discagem de emergência podem ser definidas, separando-se os valores por ponto-e-vírgula. Por exemplo: -EmergencyDialMask “212;414”.

IMPORTANTE. Garanta que o valor da máscara de discagem especificado não seja igual a um número no intervalo da órbita de estacionamento de chamadas. O roteamento do estacionamento de chamadas terá precedência sobre a conversão de cadeias de caracteres de discagem de emergência. Para ver os intervalos de órbita do estacionamento de chamadas existentes, chame o cmdlet Get-CsCallParkOrbit.

O comprimento máximo da cadeia de caracteres é 100. Cada caractere deve ser um dígito entre 0 e 9.

EmergencyDialString

Opcional

Cadeia de caracteres

O número que é discado para se acessar os serviços de emergência. Nos Estados Unidos, esse valor é 911.

A cadeia de caracteres deve ser composta pelos dígitos 0 a 9 e pode ter entre um e dez dígitos de comprimento.

EnhancedEmergencyServicesEnabled

Obrigatório

Booleano

Especifica se os usuários associados a esta política estarão habilitados para o E9-1-1. Defina o valor como True, para habilitar o E9-1-1, de forma que os clientes do Lync Server 2010 recuperem as informações de localização no registro e as incluam quando forem realizadas chamadas de emergência.

Valor padrão: False

LocationRequired

Opcional

LocationRequiredEnum

Se o cliente não tiver conseguido recuperar um local no banco de dados de configuração de localização, o usuário poderá ser solicitado a digitar um local manualmente. Esse parâmetro aceita os seguintes valores:

- no: O usuário não será solicitado a digitar um local. Quando uma chamada for feita sem informações de local, o Provedor de serviços de emergência responderá à chamada e solicitará o local.

- yes: O usuário será solicitado a digitar as informações de local quando o cliente se registrar em um novo local. O usuário pode recusar o aviso, sem digitar qualquer informação. Se forem digitadas informações, uma chamada feita para 911 será atendida primeiramente pelo Provedor de serviços de emergência, para verificar o local, antes de ser encaminhada para o operador do PSAP (o operador do 911).

- disclaimer: Esta opção é a mesma que sim, exceto pelo fato que se o usuário recusar a isenção de aviso, o texto será exibido para alertar o usuário das consequências em recusar a informação de localização (o texto de isenção de responsabilidade deve ser definido ao se chamar o cmdlet Set-CsEnhancedEmergencyServiceDisclaimer).

Este valor será ignorado se EnhancedEmergencyServicesEnabled for definida como False (o padrão). Os usuários não serão solicitados a digitar informações de local.

NotificationUri

Opcional

Cadeia de caracteres

Um ou mais URIs do SIP a serem notificados quando se realiza uma chamada de emergência. Por exemplo, o escritório de segurança da empresa poderia ser avisado, por meio de uma mensagem instantânea, sempre que ocorrer uma chamada de emergência. Se a localização do chamador estiver disponível, ela será incluída na notificação.

Vários URIs do SIP podem ser incluídos como uma lista separada por vírgulas. Por exemplo: -NotificationUri sip:security@litwareinc.com,sip:kmyer@litwareinc.com. Tenha em mente que não há suporte para as listas de distribuição e os URIs de grupo.

A cadeia de caracteres deve ter entre um e 256 caracteres de comprimento e deve começar com o prefixo sip:.

PstnUsage

Opcional

Cadeia de caracteres

O uso da rede telefônica pública comutada (PSTN) que será usada para determinar qual rota de voz será utilizada para encaminhar as chamadas de emergência de clientes que estiverem utilizando este perfil. A rota associada a este uso deveria apontar para um tronco SIP dedicado a chamadas de emergência.

A utilização já deve existir na lista global das utilizações da PSTN. Chame o cmdlet Get-CsPstnUsage, para recuperar uma lista de utilizações. Para criar uma nova utilização, chame o cmdlet Set-CsPstnUsage.

UseLocationForE911Only

Opcional

Booleano

As informações de localização podem ser utilizadas pelo cliente do Microsoft Lync 2010 com várias finalidades (como avisar os companheiros de equipe sobre o local em uso, por exemplo). Defina este valor como True, para garantir que as informações de localização estejam disponíveis somente para uso por uma chamada de emergência.

Force

Opcional

SwitchParameter

Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as alterações.

InMemory

Opcional

SwitchParameter

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.

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

Nenhuma.

Tipos de Retorno

Cria um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy.

Exemplo

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

New-CsLocationPolicy -Identity site:Redmond -EnhancedEmergencyServicesEnabled $True

O Exemplo 1 utiliza o cmdlet New-CsLocationPolicy para criar uma nova política de localização para o site de Redmond, que habilita o E9-1-1 para todos os usuários desse site. Para criar esta política, chama-se New-CsLocationPolicy, juntamente com dois parâmetros: um para definir a identidade, que neste caso é a cadeia de caracteres site: seguida pelo nome do site ao qual esta política se aplica; o outro para definir como True o valor da propriedade EnhancedEmergencyServicesEnabled.

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

New-CsLocationPolicy -Identity Reno -Description "All users located at the Reno site" -EnhancedEmergencyServicesEnabled $True -PstnUsage Emergency -EmergencyDialString 911

Este exemplo cria uma política de localização por usuário. (as políticas por usuário devem ser concedidas especificamente a cada usuário ou grupo.) A identidade desta política é Reno. Uma descrição mais detalhada da política foi adicionada, utilizando-se o parâmetro Description. O próximo parâmetro fornecido será EnhancedEmergencyServicesEnabled, que é definido como True para habilitar a funcionalidade do E9-1-1 para todos os usuários aos quais esta política for concedida. O próximo parâmetro será PstnUsage, neste caso com valor igual a Emergency. Este valor deve corresponder a um valor na lista de usos da PSTN. (esta lista pode ser recuperada chamando-se Get-CsPstnUsage). O uso deveria estar associado a uma rota de voz que será utilizada para efetuar chamadas de emergência. (é possível recuperar as rotas de voz chamando-se o cmdlet Get-CsVoiceRoute). O último parâmetro utilizado neste exemplo é EmergencyDialString, que especifica o número discado para fazer uma chamada de emergência.