• Artigo

Get-CsWebServiceConfiguration

 

Tópico modificado em: 2012-03-23

Retorna informações sobre todas as definições de configuração do Serviços Web em uso na organização.

Sintaxe

Get-CsWebServiceConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsWebServiceConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrição Detalhada

Muitos componentes do Microsoft Lync Server 2010 se baseiam na Web: esses componentes utilizam serviços Web ou páginas da Web para realizar suas tarefas. Por exemplo: os usuários empregam um serviço Web ao pesquisar novos contatos no Catálogo de Endereços ou ao utilizar a expansão de um grupo para examinar cada membro de um grupo de distribuição. Da mesma forma, componentes como conferências discadas e Painel de Controle do Microsoft Lync Server 2010 utilizam páginas da Web como interface entre o Lync Server 2010 e os usuários.

Os cmdlets CsWebServiceConfiguration permitem que os administradores gerenciem as definições de configuração do Serviços Web em toda a organização. Isso inclui o gerenciamento da expansão de grupos, definições de certificados e métodos permitidos de autenticação. Como é possível configurar definições diferentes nos escopos global, de site e de serviço (embora apenas para o serviço WebServer), é possível personalizar as capacidades do Serviços Web para diferentes usuários e diferentes locais.

O cmdlet Get-CsWebServiceConfiguration permite retornar informações detalhadas sobre as definições de configuração do Serviços Web em uso na organização.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsWebServiceConfiguration localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Identidade de Xds

Identificador exclusivo das definições de configuração do Serviços Web a serem retornadas. Para retornar as definições globais, utilize esta sintaxe: -Identity global. Para retornar as definições configuradas no escopo do site, utilize uma sintaxe similar a esta: -Identity "site:Redmond." As definições de serviço e escopo podem ser retornadas utilizando-se uma sintaxe como esta: -Identity "service:WebServer:atl-cs-001.litwareinc.com".

Não é possível utilizar os parâmetros Filter e Identity no mesmo comando. Se nenhum dos dois parâmetros for especificado, Get-CsWebServiceConfiguration retornará todas as coleções de definições de Serviços Web em uso na organização.

Filter

Opcional

Cadeia de caracteres

Permite utilizar caracteres curinga ao especificar a coleção (ou coleções) de configurações de Serviços Web a ser(em) retornada(s). Por exemplo, esta sintaxe retorna todas as definições configuradas no escopo de site: -Filter "site:*"

Não é possível utilizar os parâmetros Filter e Identity no mesmo comando.

LocalStore

Opcional

Parâmetro de opção

Recupera os dados de configuração de Serviços Web na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsWebServiceConfiguration não aceita a entrada canalizada.

Tipos de Retorno

Get-CsWebServiceConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Web.WebServiceSettings.

Exemplo

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

Get-CsWebServiceConfiguration

O comando precedente retorna informações sobre todas as definições de configuração de Serviços Web em uso na organização.

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

Get-CsWebServiceConfiguration -Identity site:Redmond

O comando apresentado no Exemplo 2 retorna informações sobre as definições de configuração de Serviços Web cuja identidade for site:Redmond.

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

Get-CsWebServiceConfiguration -Filter "site:*"

O Exemplo 3 retorna todas as definições de configuração de Serviços Web que tiverem sido atribuídas no escopo de site. Para fazer isso, o parâmetro Filter é incluído ao se chamar Get-CsWebServiceConfiguration; o valor de filtro "site:*" garante que apenas as definições que tiverem uma identidade começando com o valor da cadeia de caracteres "site:" serão retornadas.

-------------------------- Exemplo 4 ------------------------

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

No Exemplo 4, o comando retorna todas as definições de configuração de Serviços Web que não permitirem a autenticação por PIN. Isto é feito chamando-se Get-CsWebServiceConfiguration, para retornar todas as definições de configuração do Serviços Web em uso. Esta coleção será canalizada para o cmdlet Where-Object, que selecionará apenas as definições cuja propriedade UsePinAuth for igual a False.

-------------------------- Exemplo 5 ------------------------

Get-CsWebServiceConfiguration | Where-Object {$_.MaxGroupSizeToExpand -gt 100}

O comando anterior retorna todas as definições de configuração de Serviços Web nas quais o tamanho máximo de expansão de grupo for maior do que 100. Para fazer isso, o comando utiliza primeiramente Get-CsWebServiceConfiguration, para retornar todas as definições de configuração de Serviços Web em uso. Esta informação será canalizada para o cmdlet Where-Object, que selecionará apenas as definições nas quais a propriedade MaxGroupSizeToExpand for maior do que 100.