New-CsMcxConfiguration

 

Tópico modificado em: 2012-04-23

Cria um novo conjunto existente das definições de configuração do Microsoft Lync Server 2010 Mobility Service local ou no escopo de serviço. O Mobility Service permite que os usuários de telefones móveis (como iPhones e Windows Phones) façam operações como trocar mensagens instantâneas e informações de presença; armazenem e recuperam a caixa postal internamente e não com o provedor sem fio; e aproveitem as vantagens dos recursos do Microsoft Lync Server 2010, como a Chamada via Trabalho ou a conferência discada.

Sintaxe

New-CsMcxConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-ExposedWebURL <External | Internal>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-PushNotificationProxyUri <String>] [-SessionExpirationInterval <UInt32>] [-SessionShortExpirationInterval <UInt32>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O Microsoft Lync Server 2010 Mobility Service estende muitos dos recursos do Microsoft Lync 2010 para dispositivos móveis, como Apple iPhones, Windows Phone, telefones Android e telefones Nokia. Entre outras coisas, os usuários podem usar esses telefones para trocar mensagens instantâneas e informações de presença, e para receber notificações de novas caixas postais. Graças ao serviço de notificação de envio por push (Apple Push Notification Service e Microsoft Lync Server 2010 Push Notification Service), os usuários com iPhones ou Windows Phones podem receber essas notificações, mesmo quando o Lync 2010 está sendo executado em segundo plano. O Mobility Service também fornece a oportunidade para as organizações habilitarem a Chamada via Trabalho. Com a Chamada via Trabalho, os usuários podem fazer uma chamada de seu celular e fazer com que ela pareça ter sido originada do telefone comercial; por exemplo, os sistemas de ID de Chamadas exibirão o número comercial do usuário, em vez do número do celular dele(a).

O Mobility Service é gerenciado usando as definições de configuração do Mobility Service que podem ser aplicadas no escopo global, no escopo de site ou no escopo de serviço (somente para o serviço de servidor Web). Essas configurações controlam determinadas características, como o período de tempo máximo de uma sessão do Mobility Service; se o Microsoft Lync Server 2010 Autodiscovery Service (que direciona os usuários do Mobility Service para o pool do Registrador apropriado) está disponível para os usuários que fazem logon fora do firewall da organização); e o local do provedor do serviço de notificação de envio por push.

Quando você instala o Lync Server 2010, uma única coleção das definições de configuração do Mobility Service é criada no escopo global; no entanto, os administradores podem usar o cmdlet New-CsMcxConfiguration para criar definições de configuração personalizadas no site ou no escopo de serviço.

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

Parâmetros

Parâmetro	Obrigatório	Tipo	Descrição
Identity	Obrigatório	XdsIdentity	Identificador exclusivo da coleção de definições de configuração do Mobility Service a serem criadas. Para criar as definições no escopo de site, utilize o prefixo "site:", seguido pelo nome do site. Por exemplo: -Identity "site:Redmond" Para criar as definições configuradas no escopo do serviço, use uma sintaxe como esta: -Identity service:WebServer:atl-cs-001.litwareinc.com
ExposedWebURL	Opcional	ExposedWebURL object	Indica se a URL usada pelo Autodiscovery Service está acessível aos usuários dentro e fora do firewall da organização (Externo) ou acessível somente aos usuários dentro do firewall (Interno). Os valores permitidos são: Internal ou External. O valor padrão é External.
PushNotificationProxyUri	Opcional	Cadeia de caracteres	URI do provedor de serviços que pode encaminhar as solicitações de notificação de envio por push para o Apple Push Notification Service e o Microsoft Lync Server 2010 Push Notification Service. A PushNotificationProxyUri deve estar na forma de um endereço SIP; por exemplo: -PushNotificationProxyUri "sip:push@push.lync.com"
SessionExpirationInterval	Opcional	Inteiro	Período de tempo, em segundos, de uma sessão móvel para usuários do iPhone ou Windows Phone. Se o Lync 2010 estiver sendo executado em segundo plano nesses telefones, os usuários receberão notificações de envio por push enquanto o intervalo de expiração de sessão ainda não tiver expirado. O dispositivo móvel deve enviar um aviso para o servidor indicando que o dispositivo ainda está ativo antes do tempo limite de sessão ser atingido. Se não estiver, o dispositivo será listado como inativo e o usuario terá que fazer logon de volta no sistema. Essa propriedade pode ser definida como qualquer número inteiro entre 120 e 4294967295. O valor padrão é 259.200 segundos (3 dias). Observe que o valor da propriedade SessionExpirationInterval deve ser maior que o valor da propriedade SessionShortExpirationInterval.
SessionShortExpirationInterval	Opcional	Inteiro	Período de tempo, em segundos, de uma sessão móvel para usuários de telefone Android ou Nokia. O dispositivo móvel deve enviar um aviso para o servidor indicando que o dispositivo ainda está ativo antes do tempo limite de sessão ser atingido. Se não estiver, o dispositivo será listado como inativo e o usuário terá que fazer login de volta no sistema. Essa propriedade pode ser definida como qualquer número inteiro entre 120 e 4294967295. O valor padrão é 259.200 segundos (3 dias). Observe que o valor da propriedade SessionExpirationInterval deve ser maior que o valor da propriedade SessionShortExpirationInterval.
InMemory	Opcional	SwitchParameter	Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída de um comando 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 o cmdlet coincidente Set- deste cmdlet.
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

Nenhuma. New-CsMcxConfiguration não aceita a entrada canalizada.

Tipos de Retorno

Cria novas instâncias do objeto Microsoft.Rtc.Management.WriteableConfig.Settings.McxConfiguration.McxConfiguration.

Exemplo

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

New-CsMcxConfiguration -Identity "site:Redmond" -ExposedWebURL Internal -SessionShortExpirationInterval 7200

No Exemplo 1, uma nova coleção de definições de configuração do Mobility Service é criada (e atribuída automaticamente) para o site Redmond. Nesse exemplo, são feitas duas alterações nas definições de configuração padrão do Mobility Service: a propriedade ExposedWebURL é definida como Internal e a propriedade SessionShortExpirationInterval é definida como 7200 segundos.

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

Get-CsService -WebServer | ForEach-Object {New-CsMcxConfiguration -Identity $_.Identity -ExposedWebURL Internal -SessionShortExpirationInterval 7200}

No Exemplo 2, um conjunto idêntico das definições de configuração do Mobility Service é criada para cada servidor Web sendo usado atualmente em uma organização. Para executar essa tarefa, o cmdlet Get-CsService é usado com o parâmetro WebServer para retornar uma coleção de todos os servidores Web existentes. Essa coleção será então canalizada para o cmdlet de objeto For-Each. Por sua vez, o ForEach-Object seleciona cada servidor na coleção e executa o cmdlet New-CsMcxConfiguration para criar novas definições de configuração do Mobility Service nesse servidor.

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

$x = New-CsMcxConfiguration -Identity "site:Redmond" -InMemory
$x.ExposedWebURL = "Internal"
$x.SessionShortExpirationInterval = 7200
Set-CsMcxConfiguration -Instance $x

O exemplo anterior demonstra como o parâmetro InMemory permite que você crie uma nova coleção de definições de configuração do Mobility Service na memória, modifique os valores de propriedade dessa coleção e salve a coleção no Lync Server. Para fazer isso, o primeiro comando na coleção cria uma nova coleção de definições de configuração do Mobility Service que têm a Identidade site:Redmond. No entanto, em vez se serem criadas e atribuídas automaticamente ao site Redmond, essas configurações são criadas somente na memória (devido ao parâmetro InMemory) e são armazenadas em uma variável denominada $x.

Os comandos 2 e 3 no exemplo mostram como você pode modificar os valores de propriedade desta coleção de configurações virtuais do Mobility Service. Depois de concluir a modificação dos valores de propriedade, você pode usar o cmdlet Set-CsMcxConfiguration e o parâmetro Instance para converter as configurações virtuais em uma coleção real de definições de configuração do Mobility Service atribuídas ao site Redmond. Observe que, se você não chamar o Set-CsMcxConfiguration, nenhuma configuração será atribuída jamais ao site Redmond e sua coleção virtual desaparecerá assim que você sair da sessão do Windows PowerShell ou excluir a variável $x.