Set-CsWebServer
Tópico modificado em: 2012-03-25
Modifica um ou mais dos serviços do Servidor Web usados pelo Microsoft Lync Server 2010.
Sintaxe
Set-CsWebServer [-Identity <XdsGlobalRelativeIdentity>] [-AppSharingPortCount <UInt16>] [-AppSharingPortStart <UInt16>] [-Confirm [<SwitchParameter>]] [-ExternalFqdn <Fqdn>] [-ExternalHttpPort <UInt16>] [-ExternalHttpsPort <UInt16>] [-Force <SwitchParameter>] [-InternalFqdn <Fqdn>] [-McxSipExternalListeningPort <UInt16>] [-McxSipPrimaryListeningPort <UInt16>] [-PrimaryHttpPort <UInt16>] [-PrimaryHttpsPort <UInt16>] [-PublishedExternalHttpPort <UInt16>] [-PublishedExternalHttpsPort <UInt16>] [-PublishedPrimaryHttpPort <UInt16>] [-PublishedPrimaryHttpsPort <UInt16>] [-ReachExternalPsomServerPort <UInt16>] [-ReachPrimaryPsomServerPort <UInt16>] [-UserServer <String>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
O Lync Server 2010 faz uso extenso de servidores Web e serviços web. Por exemplo: as consultas ao Catálogos de endereços podem ser conduzidas utilizando-se serviços web (o serviço Consulta à Web do Catálogo de endereços). O Lync Server também hospeda webpages que permitem aos usuários executar tarefas como configurar os seus números de identificação pessoal (PINs) de conferências discadas. Considerando-se o papel importante desempenhado pelos servidores Web e serviços web, é fundamental que os administradores conheçam como estes servidores e serviços são configurados. Essas informações podem ser recuperadas utilizando-se o seguinte comando:
Get-CsService –WebServer
Também há situações em que é fundamental que os administradores possam mudar a forma como os seus servidores Web são configurados. Por exemplo: pode ser necessário modificar a porta usada nas conexões externas HTTP ou HTTPS. Trocas de porta como essas (assim como outras modificações) podem ser realizadas utilizando-se o cmdlet Set-CsWebServer.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsWebServer localmente: 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 (inclusive qualquer função RBAC personalizada criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsWebServer"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
Identidade de Xds |
Identificador exclusivo do pool de serviços web. Por exemplo: -Identity "WebServer:atl-cs-001.litwareinc.com". Observe que você pode omitir o prefixo "WebServer:" ao especificar um servidor Web. Por exemplo: -Identity "atl-cs-001.litwareinc.com". |
AppSharingPortCount |
Opcional |
Inteiro |
Número total de portas alocadas para o compartilhamento de aplicativos. As portas a serem abertas serão iniciadas com o valor configurado em AppSharingPortStart e continuarão até o número de portas especificado em AppSharingPortCount. Por exemplo, se AppSharingPortStart estiver definido como 60.000 e AppSharingPortCount estiver definido como 100, serão utilizadas as portas 60.000 a 60.099 para o compartilhamento de aplicativos. O valor padrão é 16383. |
AppSharingPortStart |
Opcional |
Inteiro |
Primeira porta da série de portas alocadas para o compartilhamento de aplicativos. O valor padrão é 49152. |
ExternalFqdn |
Opcional |
Cadeia de caracteres |
Nome de domínio totalmente qualificado (FQDN) utilizado por pessoas que se conectarem ao pool de Serviços Web de fora da rede interna. Por exemplo: -ExternalFqdn "www.litwareinc.com". |
ExternalHttpPort |
Opcional |
Inteiro |
Número da porta para conexões web externas, realizadas mediante o uso do protocolo HTTP. O valor padrão é a porta 8080. |
ExternalHttpsPort |
Opcional |
Inteiro |
Número da porta para conexões web externas, realizadas mediante o uso do protocolo HTTPS. O valor padrão é a porta 4443. |
InternalFqdn |
Opcional |
Cadeia de caracteres |
Nome de domínio totalmente qualificado para o Mobility Services. O InternalFqdn só deve ser acessível de dentro do firewall da organização. |
McxSipExternalListeningPort |
Opcional |
Inteiro |
Porta de escuta externa para o serviço Mobility. |
McxSipPrimaryListeningPort |
Opcional |
Inteiro |
Porta de escuta interna para o serviço Mobility. |
PrimaryHttpPort |
Opcional |
Inteiro |
Número da porta para conexões web internas, realizadas mediante o uso do protocolo HTTP. O valor padrão é a porta 80. |
PrimaryHttpsPort |
Opcional |
Inteiro |
Número da porta para conexões web internas, realizadas mediante o uso do protocolo HTTPS. O valor padrão é a porta 443. |
PublishedExternalHttpsPort |
Opcional |
Inteiro |
Porta externa para o serviço Mobility. |
PublishedPrimaryHttpsPort |
Opcional |
Inteiro |
Porta interna para o serviço Mobility. |
ReachExternalPsomServerPort |
Opcional |
Inteiro |
Número de porta externa para o Protocolo do modelo de objetos compartilhados persistentes, um protocolo da Microsoft utilizado em conferências. O número de porta padrão é 8061. |
ReachPrimaryPsomServerPort |
Opcional |
Inteiro |
Número de porta primária para o Protocolo do modelo de objetos compartilhados persistentes (PSOM), um protocolo da Microsoft utilizado em conferências. O número de porta padrão é 8060. |
UserServer |
Opcional |
Cadeia de caracteres |
ID de serviço do pool de serviços de usuário associado ao pool de serviços Web. Por exemplo: -UserServer "UserServer:atl-cs-001.litwareinc.com". |
Force |
Opcional |
Parâmetro de opção |
Suprime a exibição de qualquer mensagem de erro não-fatal que possa surgir durante a execução do comando. |
WhatIf |
Opcional |
Parâmetro 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
Nenhuma. Set-CsWebServer não aceita entradas canalizadas.
Tipos de Retorno
Nenhuma. Em vez disso, Set-CsWebServer modifica instâncias do objeto Microsoft.Rtc.Management.Xds.DisplayWebServer.
Exemplo
-------------------------- Exemplo 1 ------------------------
Set-CsWebServer -Identity "WebServer:atl-cs-001.litwareinc.com" -PrimaryHttpPort 89
O comando mostrado no Exemplo 1 modifica PrimaryHttpPort de um único pool de serviços Web: o pool cuja Identidade for igual a WebServer:atl-cs-001.litwareinc.com. Neste exemplo, o número da porta é alterado para 89.
-------------------------- Exemplo 2 ------------------------
Get-CsService -WebServer | ForEach-Object {Set-CsWebServer -Identity $_.Identity -PrimaryHttpPort 89}
O comando mostrado no Exemplo 2 é uma variação do comando mostrado no Exemplo 1. Neste caso, modifica-se PrimaryHttpPort de todos os pools de serviços Web utilizados na organização. Para isso, o comando usa primeiramente Get-CsService e o parâmetro WebServer, para retornar uma coleção de todos os pools de serviços Web em uso. Esta coleção será então canalizada para o cmdlet ForEach-Object, que selecionará cada pool na coleção e definirá PrimaryHttpPort para a porta 89. Os dados deverão ser canalizados para ForEach-Object porque o cmdlet Set-CsWebServer não aceita dados canalizados.