Set-CsMcxConfiguration

 

Tópico modificado em: 2012-04-23

Modifica uma coleção existente das definições de configuração do Microsoft Lync Server 2010 Mobility Service. 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

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

Set-CsMcxConfiguration [-Confirm [<SwitchParameter>]] [-ExposedWebURL <External | Internal>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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.

O cmdlet Set-CsMcxConfiguration fornece uma maneira para os administradores modificarem quaisquer definições existentes da configuração do Mobility Service.

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

Parâmetros

Parâmetro	Obrigatório	Tipo	Descrição
Identity	Opcional	XdsIdentity	Representa o identificador exclusivo da coleção de definições de configuração do Mobility Service a ser modificada. Para modificar as configurações globais, utilize a seguinte sintaxe: -Identity global Para modificar as definições no escopo de site, utilize o prefixo "site:", seguido pelo nome do site. Por exemplo: -Identity "site:Redmond" Para modificar as definições configuradas no escopo de serviço, utilize uma sintaxe semelhante a esta: -Identity service:WebServer:atl-cs-001.litwareinc.com Se este parâmetro não for especificado, Set-CsMcxConfiguration modificará as definições globais.
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.
Instance	Opcional	Objeto MCX Configuration	Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais.
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, inclusive. O valor padrão é 259200 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.
Force	Opcional	SwitchParameter	Suprime a exibição de qualquer mensagem de erro não-fatal que possa surgir 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

Objeto Microsoft.Rtc.Management.WriteableConfig.Settings.McxConfiguration.McxConfiguration. Set-CsMcxConfiguration aceita instâncias canalizadas do objeto McxConfiguration.

Tipos de Retorno

Nenhum. Em vez disso, Set-CsMcxConfiguration modifica instâncias existentes do objeto Microsoft.Rtc.Management.WriteableConfig.Settings.McxConfiguration.McxConfiguration.

Exemplo

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

Set-CsMcxConfiguration -Identity site:Redmond -ExposedWebURL External

No Exemplo 1, a propriedade ExposedWebURL das definições de configuração do Mobility Service atribuídas ao site Redmond é definida como External.

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

Get-CsMcxConfiguration | Set-CsMcxConfiguration -ExposedWebURL External

O Exemplo 2 mostra como um único comando pode atribuir o mesmo valor de propriedade a todas as definições de configuração do Mobility Service sendo usadas no momento em uma organização. Para fazer isso, o comando usa primeiro o cmdlet Get-CsMcxConfiguration sem nenhum parâmetro para retornar uma coleção de todas as definições existentes de configuração do Mobility Service. Essa coleção será canalizada para o Set-CsMcxConfiguration, que definirá a propriedade ExposedWebURL de cada item na coleção como sendo External.

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

Get-CsMcxConfiguration | Where-Object {$_.SessionShortExpirationInterval -gt 3600} | Set-CsMcxConfiguration -SessionShortExpirationInterval 3600

No exemplo anterior, todas as definições de configuração do Mobility Service que têm um SessionShortExpirationInterval de mais de 3600 segundos são modificadas para definir esse valor de propriedade como 3600; isso efetivamente torna 3600 segundos o valor máximo para todas as definições de configuração do Mobility Service configuration na organização. Para fazer isso, o cmdlet Get-CsMcxConfiguration será chamado primeiro (sem quaisquer parâmetros), para retornar uma coleção de todas as definições de configuração do Mobility Service em uso. Essa coleção é então canalizada para o cmdlet Where-Object, que selecionará somente as configurações nas quais a propriedade SessionShortExpirationInterval for maior que (-gt) 3600. Essa coleção filtrada será canalizada para o Set-CsMcxConfiguration, que definirá o valor da propriedade SessionShortExpirationInterval de cada item na coleção como 3600.