Get-CsMcxConfiguration
Tópico modificado em: 2012-04-23
Recupera as informações sobre as definições de configuração do Microsoft Lync Server 2010 Mobility Service sendo usadas atualmente em sua organizaçã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 Lync Server 2010, como a Chamada via Trabalho ou a conferência discada.
Sintaxe
Get-CsMcxConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsMcxConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]
Descrição Detalhada
O 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 visualizarã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 Get-CsMcxConfiguration fornece uma maneira para os administradores recuperarem as informações sobre todas as definições de configuração do Mobility Service em uso no momento na organização.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsMcxConfiguration localmente: RTCUniversalServerAdmins.
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Opcional |
XdsIdentity |
Indica o identificador exclusivo da coleção de definições de configuração do Mobility Service que se deseja retornar. Para se referir às configurações globais, use esta sintaxe: -Identity global Para referir-se à coleção configurada no escopo do site, use a sintaxe semelhante a esta: -Identity site:Redmond Para referir-se a uma coleção configurada no escopo de serviço, use uma sintaxe semelhante a esta: -Identity service:WebServer:atl-cs-001.litwareinc.com Observe que você não pode usar curingas quando especificando uma Identity. Se for necessário usar curingas, use o parâmetro Filter, no lugar. Se esse parâmetro não for especificado, Get-CsMcxConfiguration retornará uma coleção de todas as definições de configuração do Mobility Service em uso na organização. |
Filter |
Opcional |
Cadeia de caracteres |
Permite usar caracteres curinga para retornar uma coleção de definições de configuração do Mobility Service. Por exemplo, para retornar uma coleção de todas as configurações definidas no escopo do site, use esta sintaxe: -Filter site:* Para retornar uma coleção de todas as definições configuradas no serviço, utilize esta sintaxe: -Filter service:* |
LocalStore |
Opcional |
Parâmetro de opção |
Recupera os dados da configuração do Mobility Service da réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si. |
Tipos de Entrada
Get-CsMcxConfiguration não aceita a entrada canalizada.
Tipos de Retorno
Get-CsMcxConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WriteableConfig.Settings.McxConfiguration.McxConfiguration.
Exemplo
-------------------------- Exemplo 1 --------------------------
Get-CsMcxConfiguration
O comando apresentado no Exemplo 1 retorna as informações sobre todas as definições de configuração do Mobility Service em uso na organização.
-------------------------- Exemplo 2 --------------------------
Get-CsMcxConfiguration -Identity "global"
No Exemplo 2, as informações são retornadas somente para a coleção global das definições de configuração do Mobility Service.
-------------------------- Exemplo 3 --------------------------
Get-CsMcxConfiguration -Filter "service:*"
O Exemplo 3 retorna as informações sobre as definições de configuração do Mobility Service atribuídas ao escopo do serviço. Para isso, o parâmetro Filter é incluído com o valor de cadeia de caracteres "service:*". Esse valor de filtro retorna todas as definições de configuração do Mobility Service que têm uma Identidade que começa com o valor de cadeia de caracteres "service:".
-------------------------- Exemplo 4 --------------------------
Get-CsMcxConfiguration | Where-Object {$_.ExposedWebURL -eq "External"}
No Exemplo 4, as únicas definições de configuração do Mobility Service retornadas são aquelas nas quais a propriedade ExposedWebURL é igual a External. Para fazer isso, o comando chama primeiro Get-CsMcxConfiguration sem quaisquer parâmetros, para retornar uma coleção de todas as definições de configuração do Mobility Service em uso na organização. Essa coleção será canalizada para o cmdlet Where-Object cmdlet, que selecionará apenas as definições nas quais a propriedade ExposedWebURL for igual a (-eq) External.
-------------------------- Exemplo 5 --------------------------
Get-CsMcxConfiguration | Where-Object {$_.SessionExpirationInterval -lt 259200}
O Exemplo 5 retorna qualquer e todas as definições de configuração do Mobility Service nas quais a propriedade SessionExpirationInterval está definida como um valor menor que o valor padrão de 259200 segundos (72 horas). Isso é feito usando primeiro Get-CsMcxConfiguration para retornar uma coleção de todas as definições de configuração existentes do Mobility Service. Essa coleção será então canalizada para o cmdlet Where-Object, que selecionará apenas as definições cuja propriedade SessionExpirationInterval for menor do que 259200.