Set-CsWebServiceConfiguration
Tópico modificado em: 2012-04-23
Modifica uma coleção existente de configurações do Serviços Web.
Sintaxe
Set-CsWebServiceConfiguration [-Identity <XdsIdentity>] [-AllowAnonymousAccessToLWAConference <$true | $false>] [-CASigningKeyLength <UInt64>] [-Confirm [<SwitchParameter>]] [-DefaultValidityPeriodHours <UInt64>] [-EnableCertChainDownload <$true | $false>] [-EnableGroupExpansion <$true | $false>] [-Force <SwitchParameter>] [-InferCertChainFromSSL <$true | $false>] [-MACResolverUrl <String>] [-MaxCSRKeySize <UInt64>] [-MaxGroupSizeToExpand <UInt32>] [-MaxValidityPeriodHours <UInt64>] [-MinCSRKeySize <UInt64>] [-MinValidityPeriodHours <UInt64>] [-SecondaryLocationSourceUrl <String>] [-ShowDownloadCommunicatorAttendeeLink <$true | $false>] [-ShowJoinUsingLegacyClientLink <$true | $false>] [-TrustedCACerts <PSListModifier>] [-UseCertificateAuth <$true | $false>] [-UsePinAuth <$true | $false>] [-UseWindowsAuth <None | Negotiate | NTLM>] [-WhatIf [<SwitchParameter>]]
Set-CsWebServiceConfiguration [-AllowAnonymousAccessToLWAConference <$true | $false>] [-CASigningKeyLength <UInt64>] [-Confirm [<SwitchParameter>]] [-DefaultValidityPeriodHours <UInt64>] [-EnableCertChainDownload <$true | $false>] [-EnableGroupExpansion <$true | $false>] [-Force <SwitchParameter>] [-InferCertChainFromSSL <$true | $false>] [-Instance <PSObject>] [-MACResolverUrl <String>] [-MaxCSRKeySize <UInt64>] [-MaxGroupSizeToExpand <UInt32>] [-MaxValidityPeriodHours <UInt64>] [-MinCSRKeySize <UInt64>] [-MinValidityPeriodHours <UInt64>] [-SecondaryLocationSourceUrl <String>] [-ShowDownloadCommunicatorAttendeeLink <$true | $false>] [-ShowJoinUsingLegacyClientLink <$true | $false>] [-TrustedCACerts <PSListModifier>] [-UseCertificateAuth <$true | $false>] [-UsePinAuth <$true | $false>] [-UseWindowsAuth <None | Negotiate | NTLM>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Muitos componentes do Microsoft Lync Server 2010 se baseiam na Web: esses componentes usam Serviços Web 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 (embora apenas para o serviço Serviços Web), você pode personalizar recursos do Serviços Web para usuários e locais diferentes. Os cmdlets CsWebServiceConfiguration (Get-CsWebServiceConfiguration, New-CsWebServiceConfiguration, Remove-CsWebServiceConfiguration e Set-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.
Configurações personalizadas (por exemplo, períodos de validade personalizados para certificados) podem ser especificadas no momento da criação de uma nova coleção de configuração de Serviços Web. Uma opção é modificar os valores da propriedade de uma coleção existente usando o cmdlet Set-CsWebServiceConfiguration.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-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 "Set-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 modificadas. Para modificar definições configuradas no escopo do site, use uma sintaxe semelhante a esta: -Identity "site:Redmond". Para modificar definições configuradas no escopo do serviço, use uma sintaxe semelhante a esta: -Identity "service:WebServer:atl-cs-001.litwareinc.com". Para modificar configurações definidas no escopo do site, use a sintaxe similar a esta: -identity global. Se o parâmetro Identity não é usado então Set-CsWebServiceConfiguration vai automaticamente modificar a coleção global. |
Instance |
Obrigatório |
Objeto WebServiceSettings |
Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais. |
AllowAnonymousAccessToLWAConference |
Opcional |
Booleano |
Quando definido como True, usuários anônimos poderão participar de conferências do Lync Web App (LWA). |
CASigningKeyLength |
Opcional |
Inteiro |
Define o tamanho da chave de assinatura da CA, a chave privada usada por uma CA (autoridade de certificação) para assinar certificados digitais. O tamanho da chave de assinatura pode ser definida como qualquer valor inteiro entre 2048 e 16384 bytes; o padrão é 2048. |
DefaultValidityPeriodHours |
Opcional |
Inteiro |
Quando usando uma autenticação de certificado, clientes podem solicitar o período de tempo (em horas) que o certificado permanece valido. DefaultValidityPeriodHours representa a quantidade de tempo que um certificado permanece válido se um cliente não solicitar um período de validade personalizado. DefaultValidityPeriodHours pode ser qualquer valor inteiro entre 8 horas e 8760 horas (365 dias). O valor padrão é 4320 (180 dias). |
EnableCertChainDownload |
Opcional |
Booleano |
Se definido como Verdadeiro, servidores apresentados com um certificado de autenticação vão baixar cadeia de certificados para este certificado. A cadeia de certificados segue o certificado individual de volta à CA emissora. Certificados não vão ser aceitos para autenticação a menos que o CA do certificado seja confiável. |
EnableGroupExpansion |
Opcional |
Se definida como True, expansão de grupo vai ser habilitada em Microsoft Lync 2010. Com grupo de expansão, usuários podem configurar um grupo de distribuição como um contato e, então, "expandir" este grupo. Quando um grupo for expandido, usuários podem ver os membros de um grupo individualmente e suas informações de presença atuais. |
|
InferCertChainFromSSL |
Opcional |
Booleano |
Se definido como True, servidores vão usar as informações do certificado incluídas no protocolo Secure Sockets Layer (SSL) para determinar a CA emissora. Certificados não vão ser aceitos para autenticação a menos que o CA do certificado seja confiável. |
MACResolverUrl |
Opcional |
Cadeia de caracteres |
URL para um serviço Web capaz de executar resolução de MAC (Controle de Acesso à Mídia). Resolução MAC envolve pegar um endereço IP e determinar o endereço MAC da placa de rede associada ao endereço IP. |
MaxCSRKeySize |
Opcional |
Inteiro |
Define o tamanho máximo da chave da Solicitação de Assinatura de Certificado (CSR). (Uma CSR é a mensagem enviada por um candidato para um CA de forma a aplicar para um certificado digital). O tamanho máximo de uma chave CSR pode ser definido como qualquer valor inteiro entre 1024 e 16384 bytes. O valor padrão é 16384. |
MaxGroupSizeToExpand |
Opcional |
Inteiro |
Representa o número máximo de pessoas que vai ser exibido quando um grupo é expandido. Por exemplo, se MaxGroupSizeToExpand é definido como 75, somente os primeiros 75 membros do grupo vão ser exibidos toda vez que o grupo for expandido. MaxGroupSizeToExpand pode ser definido para qualquer valor inteiro entre 1 e 1000, inclusive. O valor padrão é 100. |
MaxValidityPeriodHours |
Opcional |
Inteiro |
Quando usando uma autenticação de certificado, clientes podem solicitar o período de tempo (em horas) que o certificado permanece valido. MaxValidityPeriodHours representa a quantidade máxima de tempo que um cliente pode solicitar. MaxValidityPeriodHours pode ser qualquer valor inteiro entre 8 horas e 8760 horas (365 dias). O valor padrão é 8760. |
MinCSRKeySize |
Opcional |
Inteiro |
Define o tamanho mínimo da chave Solicitação de Assinatura de Certificado (CSR). O tamanho mínimo pode ser definido como qualquer valor inteiro entre 1024 e 16384 bytes. O valor padrão é 16384. |
MinValidityPeriodHours |
Opcional |
Inteiro |
Quando usando uma autenticação de certificado, clientes podem solicitar o período de tempo (em horas) que o certificado permanece valido. MinValidityPeriodHours representa a quantidade mínima de tempo que um cliente pode solicitar. MinValidityPeriodHours pode ser qualquer valor inteiro entre 8 horas e 4320 horas (180 dias). O valor padrão é 8. |
SecondaryLocationSourceUrl |
Opcional |
Cadeia de caracteres |
URL para um serviço Web que pode processar uma solicitação de localização. Este serviço só é usado quando solicitações de localização não puderem ser resolvidas localmente. |
ShowDownloadCommunicatorAttendeeLink |
Opcional |
Booleano |
Se definido como True (o valor padrão), usuários participando de uma reunião usando um aplicativo cliente que não o Lync 2010 verão um link que os direciona a um download do Lync 2010 Attendee. |
ShowJoinUsingLegacyClientLink |
Opcional |
Booleano |
Se definido como True, usuários participando de uma reunião usando um aplicativo cliente que não o Lync 2010 vão ter a oportunidade de participar da reunião usando o seu aplicativo cliente atual. O valor padrão é False. |
TrustedCACerts |
Opcional |
Coleção de certificado |
Coleção de certificados representando cadeias de certificado confiáveis pelo Servidor Web. Novos certificados adicionados à coleção devem ser criados usando o cmdlet New-CsWebTrustedCACertificate. Esta coleção não é usada se a propriedade InferCertChainFromSSL é definida como True. |
UseCertificateAuth |
Opcional |
Booleano |
Quando definido como True (o valor padrão), clientes podem ser autenticados usando certificados. Defina este valor como False para desabilitar a autenticação de certificado. |
UsePinAuth |
Opcional |
Booleano |
Quando definido como True (o valor padrão), clientes podem ser autenticados usando PINs. Defina este valor como False para desabilitar autenticação de PIN. |
UseWindowsAuth |
Opcional |
Modificador de lista PS |
Determina como (e se) usuários vão ser autenticados usando autenticação Windows; isto é, usando as mesmas credenciais que eles usaram quando eles conectaram no Windows. Valores válidos são: Negociar – O cliente e o servidor vão trabalhar juntos para determinar o protocolo de autenticação apropriado (ou Kerberos ou NTLM). NTLM – autenticação Windows vai ser permitida, mas usando o protocolo NTLM somente. Nenhum - autenticação Windows não vai ser permitida. |
Force |
Opcional |
Parâmetros de Opção |
Suprime os prompts de confirmação ou mensagens de erro não fatal que podem ocorrer quando você executa o cmdlet. |
WhatIf |
Opcional |
Parâmetros de Opção |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Confirm |
Opcional |
Parâmetro de opção |
Solicita confirmação antes da execução do comando. |
Tipos de Entrada
Objeto Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings. Set-CsWebServiceConfiguration aceita entrada em pipeline do objeto de configurações do Serviços Web.
Tipos de Retorno
Set-CsWebServiceConfiguration não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.Web.WebServiceSettings.
Exemplo
-------------------------- Exemplo 1 ------------------------
Set-CsWebServiceConfiguration -Identity site:Redmond -EnableGroupExpansion $True
O Exemplo 1 habilita a expansão de grupo para as configurações de Serviços Web aplicadas ao site Redmond (-Identity site:Redmond). Isto é feito incluindo a propriedade EnableGroupExpansion e definindo o valor do parâmetro como True.
-------------------------- Exemplo 2 ------------------------
Get-CsWebServiceConfiguration -Filter "site:*" | Set-CsWebServiceConfiguration -MaxValidityPeriodHours 16
No Exemplo 2, o período de validade máximo para todas as configurações de Serviços Web aplicadas no escopo do site é alterado para 16 horas. Para realizar esta tarefa, Get-CsWebServiceConfiguration é chamado com o parâmetro Filter; o valor de filtro "site:*" limita os dados retornados para configurações em que a Identity começa com os caracteres "site:". Esta coleção é então direcionada para Set-CsWebServiceConfiguration, que pega cada ítem na coleção e muda a propriedade MaxValidityPeriodHours para 16.
-------------------------- Exemplo 3 ------------------------
Get-CsWebServiceConfiguration | Where-Object {$_.EnableGroupExpansion -eq $True} | Set-CsWebServiceConfiguration -MaxGroupSizeToExpand 400
No comando anterior, o tamanho do grupo de expansão é definido como 400 para cada coleção de configurações de Serviços Web que permite expansão de grupo. Para fazer isso, Get-CsWebServiceConfiguration é chamado sem nenhum parâmetro; isto retorna uma coleção de todas as configurações de Serviços Web usadas na organização. Esta coleção é então direcionada para Where-Object, que seleciona somente as configurações nas quais a propriedade EnableGroupExpansion seja igual a True. Em seguida, esta coleção filtrada é direcionada para Set-CsWebServiceConfiguration, que pega cada item na coleção e define o valor da propriedade MaxGroupSizeToExpand para 400.
-------------------------- Exemplo 4 ------------------------
Set-CsWebServiceConfiguration -Identity global -ShowDownloadCommunicatorAttendeeLink $True
O comando mostrado no Exemplo 4 mostra como as configurações globais de Serviços Web podem ser definidas para que qualquer pessoa que ingresse em uma reunião usando um aplicativo cliente que não o Lync 2010 veja primeiro um link para um site onde poderá fazer o download do Lync 2010 Attendee. Isto é feito incluindo o parâmetro ShowDownloadCommunicatorAttendeeLink e definindo seu valor como $True.
Consulte Também
Outros Recursos
Get-CsWebServiceConfiguration
New-CsWebServiceConfiguration
Remove-CsWebServiceConfiguration