Compartilhar via

  • Artigo

Remove-CsWebServiceConfiguration

 

Tópico modificado em: 2012-03-26

Remove uma ou mais coleções das configurações do Serviços Web.

Sintaxe

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

Descrição Detalhada

Muitos componentes do Microsoft Lync Server 2010 se baseiam na Web: esses componentes usam serviços ou páginas da Web para realizar suas tarefas. Por exemplo, os usuários empregam um serviço Web ao procurar novos contatos no Catálogo de Endereços ou ao usar a expansão de grupo para exibir membros individuais de um grupo de distribuição. Da mesma forma, os componentes desde a conferência discada até o Painel de Controle do Microsoft Lync Server 2010 usam páginas da Web como a interface entre o Lync Server 2010 e os usuários.

Os cmdlets CsWebServiceConfiguration permitem aos administradores gerenciar definições de configuração do Serviços Web em toda a organização. Isso inclui o gerenciamento da expansão de grupo, das configurações de certificado e dos métodos de autenticação permitidos. Como é possível definir configurações diferentes no escopo global, do site e do serviço (apenas para o serviço Serviços Web), você pode personalizar recursos do Serviços Web para usuários e locais diferentes.

Se você criar definições de configuração personalizadas do Serviços Web no escopo do site ou do serviço, essas configurações poderão ser posteriormente removidas usando-se o cmdlet Remove-CsWebServiceConfiguration. Observe que também é possível executar Remove-CsWebServiceConfiguration na coleção global de configurações do Serviços Web. No entanto, nesse caso, a coleção global não será removida; isso porque o Lync Server não permite remover configurações globais. Em vez disso, serão restaurados os valores padrão de todas as propriedades na coleção global. Por exemplo, suponhamos que você tenha alterado o valor MaxGroupSizeToExpand para 500. Como o valor padrão da propriedade é 100, "remover" a coleção global redefinirá o valor da propriedade MaxGroupSizeToExpand para 100.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Remove-CsWebServiceConfiguration 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-CsWebServiceConfiguration"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Xds Identity

Identificador exclusivo das definições de configuração do Serviços Web a serem removidas. Para remover definições configuradas no escopo do site, use uma sintaxe semelhante a esta: -Identity "site:Redmond". Para remover definições configuradas no escopo do serviço, use uma sintaxe semelhante a esta: -Identity "service:WebServer:atl-cs-001.litwareinc.com".

Remove-CsWebServiceConfiguration também pode ser executado na coleção global. Nesse caso, no entanto, a coleção global não será removida; em vez disso, os valores padrão de todas as propriedades nessa coleção serão redefinidos. Para redefinir a coleção global, use esta sintaxe: -Identity global.

Force

Opcional

Parâmetros de opção

Suprime a exibição de mensagens de erro não fatais que possam ocorrer na 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

Parâmetros de opção

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

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings. Remove-CsWebServiceConfiguration aceita entrada em pipeline do objeto de configurações do Serviços Web,

Tipos de Retorno

Nenhuma. Em vez disso, Remove-CsWebServiceConfiguration exclui as instâncias existentes do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings.

Exemplo

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

Remove-CsWebServiceConfiguration -Identity site:Redmond

O comando anterior remove as definições de configuração do Serviços Web para o site de Redmond.

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

Get-CsWebServiceConfiguration -Filter "site:*" | Remove-CsWebServiceConfiguration

No Exemplo 2, todas as definições do Serviços Web configuradas no escopo do site são removidas. Para realizar essa tarefa, o comando chama inicialmente Get-CsWebServiceConfiguration e o parâmetro Filter; o valor de filtro "site:*" garante que apenas as configurações que tenham propriedade Identity começando com os caracteres "site:" sejam retornadas. Em seguida, essa coleção filtrada é redirecionada para Remove-CsWebServiceConfiguration, que exclui cada item da coleção.

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

Get-CsWebServiceConfiguration | Where-Object {$_.EnableGroupExpansion -eq $False} | Remove-CsWebServiceConfiguration

O comando mostrado no Exemplo 3 exclui todas as definições de configuração do Serviços Web em que a expansão de grupo foi desabilitada. Para isso, o comando chama inicialmente Get-CsWebServiceConfiguration sem nenhum parâmetro para retornar uma coleção de todas as definições de configuração do Serviços Web usadas na organização. Em seguida, essa coleção é redirecionada para o cmdlet Where-Object, que seleciona apenas as configurações nas quais a propriedade EnableGroupExpansion seja igual a False. Em seguida, essa coleção filtrada é redirecionada para Remove-CsWebServiceConfiguration, que exclui cada item da coleção.