Grant-CsMobilityPolicy
Tópico modificado em: 2012-04-23
Concede uma política de mobilidade por usuário a um usuário ou grupo de usuários. As políticas de mobilidade determinam se um usuário pode usar o Microsoft Lync 2010 Mobile. Essas políticas também gerenciam a capacidade de um usuário para empregar a Chamada via Trabalho, um recurso que permite aos usuários fazer e receber chamadas telefônicas em seus celulares usando seu número de telefone comercial em vez do seu número de celular.
Sintaxe
Grant-CsMobilityPolicy -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Lync 2010 Mobile é um aplicativo cliente que permite que os usuários executem o Microsoft Lync 2010 em seus celulares. A Chamada via Trabalho fornece uma maneira para os usuários fazerem chamadas em seus celulares e fazer com que a chamada pareça ter sido originada do número de telefone comercial, em vez do número de celular. Os usuários que habilitaram a Chamada via Trabalho podem obter isso discando diretamente de seu celular ou usando a opção de conferência discada. Com a conferência discada, um usuário solicita efetivamente ao servidor do Microsoft Lync Server 2010 Mobility Service para fazer uma chamada por eles. O servidor configurará a chamada e telefonará de volta em seu celular. Depois que o usuário atender, o servidor telefonará para a pessoa sendo chamada.
Estes dois recursos – a capacidade de executar o Lync Mobile e a capacidade de usar a Chamada via Trabalho – são gerenciados usando as políticas de mobilidade. Ao instalar o Microsoft Lync Server 2010, você terá uma única política de mobilidade global que se aplica a todos os seus usuários. No entanto, os administradores podem usar o cmdlet New-CsMobilityPolicy para criar políticas personalizadas no site ou no escopo por usuário.
Se você criar uma nova política no escopo do site, essa política será atribuída automaticamente ao site apropriado. No entanto, se você criar uma política de mobilidade no escopo por usuário, essa política existirá mas não será atribuída automaticamente a nenhum usuário. Em vez disso, você deve usar o cmdlet Grant-CsMobilityPolicy para atribuir especificamente uma política por usuário a um ou mais usuários.
Observe que as políticas de mobilidade não são exibidas por padrão quando você executa o cmdlet Get-CsUser. Devido a isso, você não pode visualizar a política de mobilidade por usuário atribuída a um usuário executando um comando semelhante a este:
Get-CsUser "Ken Myer"
Em vez disso, você precisará usar um comando como esse para visualizar todos os valores de propriedade (incluindo a política de mobilidade) de um usuário:
Get-CsUser "Ken Myer" | Select-Object *
Como alternativa, você pode usar um comando semelhante a este para exibir somente o nome para exibição e a política de mobilidade do usuário:
Get-CsUser "Ken Myer" | Select-Object DisplayName, MobilityPolicy
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Grant-CsMobilityPolicy localmente: RTCUniversalServerAdmins.
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
UserIdParameter |
Indica a identidade da conta do usuário à qual será atribuída a política de mobilidade por usuário. As identidades de usuário são geralmente especificadas usando um dos quatro seguintes formatos: 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). As identidades de usuário também podem ser especificadas usando o nome diferenciado do usuário no Active Directory. Além disso, você pode utilizar o caractere curinga asterisco (*) ao utilizar o Nome para Exibição como a Identidade do usuário. Por exemplo, a Identidade "* Smith" atribuirá a política a todos os usuários com nome para exibição que terminarem com o valor da cadeia de caracteres " Smith". |
PolicyName |
Opcional |
Cadeia de caracteres |
"Name" é o nome da política que será atribuída. PolicyName é apenas a Identidade da política sem seu escopo (o prefixo "tag:"). Por exemplo, uma política com a Identidade tag:Redmond tem PolicyName igual a Redmond; uma política com a Identidade tag:RedmondUsersMobilityPolicy tem PolicyName igual a RedmondUsersMobilityPolicy. -PolicyName RedmondUsersMobilityPolicy Para retirar a atribuição de uma política por usuário atribuída anteriormente a um usuário, defina PolicyName com um valor nulo ($Null): -PolicyName $Null |
DomainController |
Opcional |
Nome de domínio totalmente qualificado |
Permite especificar o FQDN (nome de domínio totalmente qualificado) de um controlador de domínio a ser contatado na atribuição da nova política. Se o parâmetro não for especificado, Grant-CsMobilityPolicy contatará o primeiro controlador de domínio disponível. |
PassThru |
Opcional |
SwitchParameter |
Permite passar um objeto de usuário através do pipeline que representa o usuário ao qual será atribuída a política. Por padrão, o cmdlet Grant-CsMobilityPolicy não canaliza objetos. |
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
Grant-CsMobilityPolicy aceita entrada em pipeline de valores de cadeia de caracteres representando o parâmetro Identity de uma conta de usuário. O cmdlet também aceita entrada em pipeline de objetos de usuário.
Tipos de Retorno
Por padrão, Grant-CsMobilityPolicy não retorna nenhum objeto ou valor. No entanto, se o parâmetro PassThru for incluído, o cmdlet será capaz de canalizar as instâncias do objeto Microsoft.Rtc.Management.ADConnect.Schema.OCSUserOrAppContact.
Exemplo
-------------------------- Exemplo 1 --------------------------
Grant-CsMobilityPolicy -Identity "Ken Myer" -PolicyName "RedmondMobilityPolicy"
O comando exibido no Exemplo 1 atribui a política de mobilidade por usuário edmondMobilityPolicy a um único usuário: Ken Myer.
-------------------------- Exemplo 2 --------------------------
Get-CsUser -Filter {MobilityPolicy -eq "NorthAmericaMobilityPolicy"} | Grant-CsMobilityPolicy -PolicyName "RedmondMobilityPolicy"
No Exemplo 2, a política de mobilidade RedmondMobilityPolicy é atribuída aos usuários gerenciados no momento pela política NorthAmericaMobilityPolicy. Para fazer isso, o comando usa primeiro o cmdlet Get-CsUser e o parâmetro Filter para recuperar todos os usuários que atribuíram a política NorthAmericaMobilityPolicy. Isso é feito usando o valor do filtro {MobilityPolicy –eq "NorthAmericaMobilityPolicy"}. Depois de recuperar a coleção de contas de usuário, essas contas são canalizadas para o cmdlet Grant-CsMobilityPolicy, que atribui cada usuário à política RedmondMobilityPolicy.
-------------------------- Exemplo 3 --------------------------
Get-CsUser -LdapFilter "l=Redmond" | Grant-CsMobilityPolicy -PolicyName "RedmondMobilityPolicy"
O comando anterior atribui a política de mobilidade RedmondMobilityPolicy a todos os usuários localizados na cidade de Redmond. Para realizar essa tarefa, o comando chama primeiro Get-CsUser juntamente com o parâmetro LdapFilter; o valor do filtro "l=Redmond" retorna todos os usuários localizados em Redmond. (O "l" representa o atributo "locality" do Active Directory.) Depois de recuperar as contas de usuário, essas contas são canalizadas para Grant-CsMobilityPolicy; por sua vez, Grant-CsMobilityPolicy atribui cada usuário à política RedmondMobilityPolicy.
-------------------------- Exemplo 4 --------------------------
Get-CsUser -Filter {RegistrarPool -eq "atl-cs-001.litwareinc.com"} | Grant-CsMobilityPolicy -PolicyName "RedmondMobilityPolicy"
No Exemplo 4, RedmondMobilityPolicy é atribuída aos usuários que tem contas do Lync Server hospedadas no atl-cs-001.litwareinc.com. Para fazer isso, o comando usa primeiro o cmdlet Get-CsUser e o parâmetro Filter para recuperar todas as contas de usuário hosperadas no pool do Registrador especificado. Isso pode ser feito usando o valor do filtro{RegistrarPool –eq "atl-cs-001.litwareinc.com"}. Depois de recuperar a coleção de contas de usuário, essas contas são canalizadas para o cmdlet Grant-CsMobilityPolicy cmdlet, que atribui cada usuário à política RedmondMobilityPolicy.