Remove-CsMcxConfiguration
Tópico modificado em: 2012-04-23
Remove o conjunto especificado de 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
Remove-CsMcxConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 criar definições de configuração personalizadas no site ou no escopo de serviço. Posteriormente, essas configurações personalizadas podem ser removidas usando o cmdlet Remove-CsMcxConfiguration. Se você remover as configurações do serviço, os servidores do Mobility Service anteriomente gerenciados por essas configurações serão gerenciados pelas configurações do site (caso existam) ou pelas configurações globais. Se você remover as configurações do site, os servidores serão gerenciados pelas configurações globais.
Observe que você também pode executar o cmdlet Remove-CsMcxConfiguration nas configurações globais. No entanto, se você fizer isso, as configurações globais não serão removidas. Em vez disso, as propriedades na coleção global serão redefinidas para seus valores padrão.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-CsMcxConfiguration localmente: RTCUniversalServerAdmins.
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
XdsIdentity |
Identificador exclusivo das definições de configuração do Mobility Service a ser modificado. Para "remover" as definições globais, use a seguinte sintaxe: -Identity global Observe que, na verdade, não é possível remover as configurações globais; o que pode ser feito é redefinir as propriedades com os seus valores padrão. Para remover as configurações do escopo do site, use uma sintaxe semelhante a esta: -Identity site:Redmond Para remover configurações definidas no escopo do serviço, use a sintaxe semelhante a esta: -Identity service:WebServer:atl-cs-001.litwareinc.com Curingas não podem ser usados para especificar uma Identidade. |
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.Settings.McxConfiguration.McxConfiguration. Remove-CsMcxConfiguration aceita entrada canalizada dos objetos McxConfiguration.
Tipos de Retorno
Nenhum. Em vez disso, o cmdlet exclui instâncias do objeto Microsoft.Rtc.Management.WriteableConfig.Settings.McxConfiguration.McxConfiguration.
Exemplo
-------------------------- Exemplo 1 --------------------------
Remove-CsMcxConfiguration -Identity "site:Redmond"
O comando mostrado no Exemplo 1 exclui a coleção de definições de configuração do Mobility Service atribuídas ao site Redmond.
-------------------------- Exemplo 2 --------------------------
Get-CsMcxConfiguration -Filter "service:*" | Remove-CsMcxConfiguration
No Exemplo 2, todas as definições de configuração do Mobility Service atribuídas ao escopo de serviço são removidas. Para fazer isso, o cmdlet Get-CsMcxConfiguration é usado com o parâmetro Filter; o valor de filtro "service:*" garante que apenas as definições nas quais a Identidade começa com o valor de cadeia de caracteres "service:" sejam retornadas. Essa coleção filtrada será canalizada para o cmdlet Remove-CsMcxConfiguration e excluída por ele.
-------------------------- Exemplo 3 --------------------------
Get-CsMcxConfiguration | Where-Object {$_.ExposedWebURL -eq "Internal"} | Remove-CsMcxConfiguration
O comando anterior exclui todas as definições de configuração do Mobility Service nas quais a propriedade ExposedWebURL está definida como Internal. Para realizar essa tarefa, o comando primeiramente chama Get-CsMcxConfiguration sem nenhum parâmetro, o que retorna 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, que selecionará apenas as definições nas quais a propriedade ExposedWebURL for igual a (-eq) Internal. Por sua vez, essa coleção filtrada será canalizada para o cmdlet Remove-CsMcxConfiguration, que excluirá todos os itens dessa coleção filtrada.
-------------------------- Exemplo 4 --------------------------
Get-CsMcxConfiguration | Where-Object {$_.PushNotificationProxyUri -eq $Null} | Remove-CsMcxConfiguration
No Exemplo 4, todas as definições de configuração do Mobility Service que não têm um URI de proxy de notificação atribuído são removidos do Lync Server. Para fazer isso, o comando usa primeiro Get-CsMcxConfiguration (sem nenhum parâmetro) para retornar uma coleção de todas as definições de configuração do Mobility Service sendo usadas no momento. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará todas as configurações nas quais a propriedade PushNotificationProxyUri for igual a (-eq) um valor Null. Todas as configurações que atenderem aos critérios serão canalizadas para o cmdlet Remove-CsMcxConfiguration e excluídas por ele.