Compartilhar via

  • Artigo

Set-CsLocationPolicy

 

Tópico modificado em: 2012-03-26

Modifica uma política de localização existente.

Sintaxe

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

Set-CsLocationPolicy [-ConferenceMode <Nullable>] [-ConferenceUri <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EmergencyDialMask <String>] [-EmergencyDialString <String>] [-EnhancedEmergencyServicesEnabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LocationRequired <Nullable>] [-NotificationUri <String>] [-PstnUsage <String>] [-UseLocationForE911Only <Nullable>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

A política de localização é usada para aplicar definições que se relacionam à funcionalidade do Enhanced 9-1-1 (E9-1-1) e à localização do cliente. 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 modifica uma política de localização existente.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-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 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 "Set-CsLocationPolicy"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Opcional

XdsIdentity

O identificador exclusivo da política de localização que se deseja modificar. Para modificar a política de localização global, utilize 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).

Instance

Opcional

LocationPolicy

Uma referência a um objeto de política de local. Este objeto deve ser do tipo Microsoft.Rtc.Management.WritableConfig.Policy.Location.LocationPolicy, que pode ser recuperado chamando-se Get-CsLocationPolicy. Recupera esse objeto, altera as propriedades na memória e passa a referência do objeto como um valor para esse parâmetro, para atualizar essa política de localização.

ConferenceMode

Opcional

ConferenceModeEnum

Se for especificado 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: "Edifício 30, terceiro andar, esquina com NorthEast".

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á). É possível definir diversas máscaras de discagem de emergência, 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 exibir os intervalos de órbitas de estacionamento de chamada 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 caracteres de comprimento.

EnhancedEmergencyServicesEnabled

Opcional

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 Lync Server recuperem as informações de localização no registro e as incluam quando forem realizadas chamadas de emergência.

LocationRequired

Opcional

LocationRequiredEnum

Se o cliente não tiver conseguido recuperar um local no banco de dados de configurações de local, 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 PSAP (ou seja, o operador do 911).

- disclaimer: Esta opção será a mesma que sim, exceto se o usuário recusar o aviso do texto de isenção de responsabilidade ao usuário exibido, alertando-o sobre as consequências de se recusar a digitar as informações de local (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 Identificadores de recursos uniformes (URIs) de SIP a serem notificados quando se fizer 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 o local do chamador estiver disponível, ele será incluído na notificação.

Vários URIs de 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.

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 entradas canalizadas de objetos de política de localização.

Tipos de Retorno

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

Exemplo

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

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

Esse comando usa o cmdlet Set-CsLocationPolicy, para modificar a política de local com a Identidade site:Redmond. (em outras palavras, ele modifica a política de local aplicada ao site de Redmond). Nesse caso, o comando define como True o valor da propriedade EnhancedEmergencyServicesEnabled, que habilitará a funcionalidade do E9-1-1 para todos os usuários conectados ao site de Redmond (nesse caso).

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

Get-CsLocationPolicy | Where-Object {$_.ConferenceUri -ne $null} | Set-CsLocationPolicy -ConferenceMode twoway

O Exemplo 2 modifica todas as políticas de localização em uso na organização que tiverem definido um URI de conferência de forma a obter um modo de conferência bidirecional. Para realizar essa tarefa, o comando utiliza primeiramente Get-CsLocationPolicy, para retornar uma coleção de todas as políticas de localização definidas. Essa coleção será então canalizada para o cmdlet Where-Object, para restringir a coleção apenas às políticas de localização cuja propriedade ConferenceUri não estiver vazia (diferente de Null). Isso resultará em uma coleção de políticas de local que possuem valores de ConferenceUri. Essa coleção será então canalizada para Set-CsLocationPolicy, que modificará o valor da propriedade ConferenceMode de cada política na coleção, definindo o valor como twoway.