Compartilhar via

  • Artigo

Remove-CsUserServicesConfiguration

 

Tópico modificado em: 2012-03-27

Remove uma coleção existente de configurações dos Serviços do Usuário. O serviço Serviços do Usuário é usado para ajudar a manter as informações de presença e gerenciar as conferências.

Sintaxe

Remove-CsUserServicesConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

O Microsoft Lync Server 2010 depende do serviço Serviços do Usuário para ajudar a manter as informações de presença dos usuários e gerenciar as reuniões e conferências. Por sua vez, os cmdlets CsUserServicesConfiguration são usados para administrar as configurações dos Serviços do Usuário em escopo global, de site e de serviço (observe que o único serviço que pode hospedar as configurações dos Serviços do Usuário é o próprio serviço Serviços do Usuário). Essas configurações ajudam a determinar coisas como a quantidade de contatos que um usuário pode ter, a quantidade de reuniões que um usuário pode agendar e por quanto tempo uma reunião pode permanecer ativa.

O cmdlet Remove-CsUserServicesConfiguration permite a exclusão das configurações dos Serviços do Usuário que tenham sido aplicadas em escopo de site ou serviço. Este cmdlet também pode ser executado contra a coleção global. Neste caso, entretanto, as configurações globais não serão excluídas; configurações globais não podem ser excluídas. Em vez disso, todas as propriedades da coleção global serão redefinidas para seus valores padrão. Por exemplo, se o valor de MaxContacts tiver sido alterado nas configurações globais para 500 e Remove-CsUserServciesConfiguration for executado, MaxContacts será redefinido ao seu valor padrão de 250.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Remove-CsUserServicesConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsUserServicesConfiguration"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Identidade Xds

Identificador exclusivo para as configurações dos Serviços do Usuário a serem removidas. Para excluir configurações definidas em escopo de site, use uma sintaxe semelhante a esta: -Identity site:Redmond. Para excluir configurações em nível de serviço, use uma sintaxe como esta: -Identity service:UserServer:atl-cs-001.litwareinc.com.

Remove-CsUserServicesConfiguration também pode ser executado contra a coleção global. Neste caso, entretanto, a coleção global não será excluída. Em vez disso, todas as propriedades da coleção serão redefinidas para seus valores padrão.

Force

Opcional

Parâmetros de opção

Suprime a exibição de mensagens de erro não fatais que possam ser geradas pela execução do comando.

WhatIf

Opcional

Parâmetros de opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

Parâmetros de opção

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings. Remove-CsUserServicesConfiguration aceita instâncias em pipeline do objeto de configurações dos Serviços do Usuário.

Tipos de Retorno

Nenhuma. Em vez disso, Remove-CsUserServicesConfiguration exclui as instâncias existentes do objeto Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.UserServicesSettings.

Exemplo

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

Remove-CsUserServicesConfiguration -Identity site:Redmond

O comando mostrado no Exemplo 1 remove as configurações dos Serviços do Usuário do site Redmond (-Identity site:Redmond).

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

Get-CsUserServicesConfiguration -Filter "service:*:" | Remove-CsUserServicesConfiguration

No Exemplo 2, todas as configurações dos Serviços do Usuário que tenham sido aplicadas em escopo de serviço são excluídas. Para fazer isso, o comando chama Get-CsUserServicesConfiguration junto com o parâmetro Filter. O valor de filtro "service:*" limita os dados retornados às configurações definidas no escopo de serviço (ou seja, configurações que tenham Identity começando com os caracteres "service:"). Em seguida, essa coleção filtrada é redirecionada para Remove-CsUserServicesConfiguration, que exclui cada item da coleção.

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

Get-CsUserServicesConfiguration | Where-Object {$_.MaxContacts -gt 250} | Remove-CsUserServicesConfiguration

O comando anterior remove todas as configurações dos Serviços do Usuário que permitam aos usuários ter mais de 250 contatos. Para executar esta tarefa, o comando primeiro chama Get-CsUserServicesConfiguration sem parâmetros para retornar uma coleção de todas as configurações dos Serviços do Usuário em uso no momento. Esta coleção é então canalizada para o cmdlet Where-Object, que seleciona apenas as configurações nas quais o valor da propriedade MaxContacts seja maior do que 250. Essas configurações são canalizadas para o cmdlet Remove-CsUserServicesConfiguration, que as remove.