Compartilhar via

  • Artigo

Grant-CsLocationPolicy

 

Tópico modificado em: 2012-03-23

Atribui uma política de localização do Enhanced 9-1-1 (E9-1-1) a usuários individuais ou grupos. O serviço E9-1-1 permite a quem atender às chamadas do 911 determinar a localização geográfica do chamador.

Sintaxe

Grant-CsLocationPolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<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 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. Esse cmdlet atribui uma política de local a um usuário ou grupo específico.

IMPORTANTE: A política de local se comporta de maneira diferente de outras políticas no Microsoft Lync Server 2010 em relação à ordem de escopo. Em todas as outras políticas, se elas forem definidas no escopo por usuário, 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ítica de site, a política global será aplicada. 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 são autorizados a executar o cmdlet Grant-CsLocationPolicy localmente: RTCUniversalUserAdmins. 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 "Grant-CsLocationPolicy"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

UserIdParameter

Indica a identidade da conta do usuário à qual será atribuída a política. As identidades de usuário podem ser especificadas utilizando-se um dos quatro formatos a seguir: 1) O endereço SIP do usuário, 2) o UPN (nome principal de usuário), 3) o nome de domínio e nome de logon do usuário, na forma domínio\logon (por exemplo: litwareinc\kenmyer) e 4) o nome de exibição do usuário no Active Directory (por exemplo: Ken Myer). Observe que SAMAccountName não pode ser usado como uma identidade.

Além disso, pode-se utilizar o caractere curinga asterisco (*) ao utilizar o nome de exibição como identidade do usuário. Por exemplo, a Identidade "* Smith" concederia a política a todos os usuários com o sobrenome Smith.

DomainController

Opcional

Fqdn

Permite especificar um controlador de domínio. Se nenhum controlador de domínio for especificado, será utilizado o primeiro disponível.

PassThru

Opcional

SwitchParameter

A inclusão desse parâmetro (que não seleciona qualquer valor) exibirá as informações do usuário quando o cmdlet for concluído. Normalmente, não haverá saída quando esse cmdlet for executado.

PolicyName

Opcional

Cadeia de caracteres

A Identidade da política de local a ser aplicada ao usuário.

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

Cadeia de caracteres. Aceita um valor canalizado de cadeia de caracteres, que representa a Identidade de uma conta de usuário à qual está sendo concedida a política de localização.

Tipos de Retorno

Quando usado com o parâmetro PassThru, retorna um objeto do tipo Microsoft.Rtc.Management.ADConnect.Schema.OCSADUserOrAppContact.

Exemplo

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

Grant-CsLocationPolicy -Identity "Ken Myer" -PolicyName Reno

No Exemplo 1, Grant-CsLocationPolicy é utilizado para atribuir a política de localização Reno ao usuário Ken Myer.

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

Get-CsUser -LDAPFilter "Department=Accounting" | Grant-CsLocationPolicy -PolicyName AccountingArea

No Exemplo 2, a política AccountingArea é atribuída a todos os usuários que estiverem no departamento de Contabilidade. Para retornar uma coleção de todos os usuários no departamento de Contabilidade, utiliza-se o cmdlet Get-CsUser, juntamente com o parâmetro LDAPFilter. O valor de consulta passado para LDAPFilter ("Department=Contabilidade") retorna todos os usuários que possuírem a definição de Departamento denominada Contabilidade no Active Directory. Esta coleção será então passada para Grant-CsLocationPolicy, que atribuirá a política AccountingArea a cada usuário na coleção.

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

Grant-CsLocationPolicy -Identity "Ken Myer" -PolicyName Reno -PassThru | Select-Object DisplayName, LocationPolicy

Esse exemplo concede a política de localização Reno ao usuário com a Identidade (nesse caso, o nome de exibição) Ken Myer. Além disso, o exemplo inclui o parâmetro PassThru, que exibirá as informações do usuário Ken Myer depois que a política de local tiver sido concedida. No entanto, em vez de exibir imediatamente as informações do usuário no console, elas serão canalizadas para o cmdlet Select-Object, que exibirá apenas as propriedades DisplayName e LocationPolicy do usuário.

Um aspecto a ser observado nesse exemplo é que a política de localização recém-concedida aparecerá na saída como LocationPolicy, mas ela aparecerá como um valor-âncora, e não como um nome de política. (um valor-âncora é um valor numérico atribuído automaticamente a uma política no momento em que ela for criada.) Para visualizar o nome da política que tiver sido aplicada, execute o comando Get-CsUser –Identity "Ken Myer" | Select-Object DisplayName, LocationPolicy.