Set-CsMobilityPolicy

 

Tópico modificado em: 2012-04-23

Modifica uma política de mobilidade existente. 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

Set-CsMobilityPolicy [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableMobility <$true | $false>] [-EnableOutsideVoice <$true | $false>] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Set-CsMobilityPolicy [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableMobility <$true | $false>] [-EnableOutsideVoice <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 2010 Mobile e a capacidade de usar a Chamada via Trabalho – são gerenciados usando as políticas de mobilidade. Essas políticas podem ser alteradas a qualquer momento usando o cmdlet Set-CsMobilityPolicy.

Além de uma descrição da política, as políticas de mobilidade têm somente duas propriedades. A primeira, EnableOutsideVoice, determina se a Chamada via Trabalho está habilitada; a segunda, EnableMobility, determina se os usuários podem usar o Lync Mobile. Essas duas propriedades devem ser definidas como true para que um usuário possa aproveitar as vantagens da Chamada via Trabalho. Se EnableMobility for definida como True e EnableOutsideVoice for definida como False, o usuário poderá executar o Microsoft Lync Mobile, mas não será capaz de usar a Chamada via Trabalho. Se EnableMobility for definida como False e EnableOutsideVoice for definida como True, o usuário não será capaz de executar o Microsoft Lync Mobile. Por sua vez, isso significa que o usuário não será capaz de usar a Chamada via Trabalho, independentemente do valor da propriedade EnableOutsideVoice.

Para usar a Chamada via Trabalho, os usuários devem ser gerenciados por uma política de voz que permite ligações simultâneas.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Set-CsMobilityPolicy localmente: RTCUniversalServerAdmins.

Parâmetros

Parâmetro	Obrigatório	Tipo	Descrição
Identity	Opcional	XdsIdentity	Identificador exclusivo atribuído à política quando ela foi criada. As políticas de mobilidade podem ser atribuídas no escopo global, do site ou por usuário. Para se referir à instância global, use esta sintaxe: -Identity global Para se referir a uma política no escopo de site, utilize uma sintaxe semelhante a essa: -Identity site:Redmond Para se referir a uma diretiva por usuário, use uma sintaxe semelhante a esta: -Identity RedmondMobilityPolicy Se você não especificar uma Identidade, Set-CsMobilityPolicy modificará a política global.
Description	Opcional	Cadeia de caracteres	Permite aos administradores fornecer texto adicional para acompanhar a política de mobilidade. Por exemplo, Descrição deve incluir informações sobre os usuários aos quais a política deve ser atribuída.
EnableMobility	Opcional	Booliano	Quando definido como True, os usuários podem usar o Microsoft Lync 2010 Mobile.
EnableOutsideVoice	Opcional	Booliano	Quando definido como True, permite que os usuários aproveitem as vantagens da Chamada via Trabalho. Quando definido como False, os usuários não podem usar a Chamada via Trabalho. O valor padrão é True.
Instance	Opcional	Objeto Mobility	Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais.
Force	Opcional	SwitchParameter	Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando.
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

Microsoft.Rtc.Management.WriteableConfig.Policy.Mobility.Mobility. Set-CsMobilityPolicy aceita instâncias canalizadas do objeto Mobility.

Tipos de Retorno

Nenhum. Em vez disso, o Set-CsMobilityPolicy modifica as instâncias existentes do objeto Microsoft.Rtc.Management.WriteableConfig.Policy.Mobility.Mobility.

Exemplo

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

Set-CsMobilityPolicy -Identity "site:Redmond" -EnableOutsideVoice $False

No Exemplo 1, a Chamada via Trabalho está desabilitada na política de mobilidade atribuída ao site Redmond. Isso é feito definindo a propriedade EnableOutsideVoice como False.

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

Get-CsMobilityPolicy -Filter "tag:*" | Set-CsMobilityPolicy -EnableOutsideVoice $False

O comando mostrado no Exemplo 2 desabilita a Chamada via Trabalho para todas as políticas de mobilidade configuradas no escopo por usuário. Para realizar essa tarefa, o comando chama primeiro o cmdlet Get-CsMobilityPolicy com parâmetro Filter parameter; o valor de filtro "tag:*" limita os dados retornados para as políticas que têm uma Identidade que começa com o valor de cadeia de caracteres "tag:". Essa coleção filtrada de políticas será então canalizada para o cmdlet Set-CsMobilityPolicy, que selecionará cada política na coleção e definirá a propriedade EnableOutsideVoice como False.

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

Get-CsMobilityPolicy | Where-Object {$_.Description -eq $Null} | Set-CsMobilityPolicy -Description "Policy owner: kenmyer@litwareinc.com"

No comando anterior, uma nova descrição é adicionada a qualquer propriedade da política de mobilidade que não tem uma descrição no momento. Para fazer isso, o comando usa primeiro Get-CsMobilityPolicy para retornar uma coleção de todas as políticas de mobilidade em uso na organização. Essa coleção será canalizada para o cmdlet Where-Object, que selecionará somente as políticas na quais a propriedade Description for igual a (-eq) um valor nulo. Essa coleção filtrada será então canalizada para o cmdlet Set-CsMobilityPolicy, que definirá a propriedade Description de cada política como o valor de cadeia de caracteres "Policy owner: kenmyer@litwareinc.com".