Set-CsWebServer
Ultima modifica dell'argomento: 2012-03-25
Consente di modificare uno o più server Web utilizzati da Microsoft Lync Server 2010.
Sintassi
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>]]
Descrizione dettagliata
Lync Server 2010 fa ampio uso dei server Web e dei servizi Web. Ad esempio, le query sulla rubrica vengono eseguite utilizzando i servizi Web (nello specifico il servizio Web di query sulla rubrica). Lync Server ospita anche le pagine Web che consentono agli utenti di eseguire operazioni come configurare i PIN per le conferenze telefoniche con accesso esterno. Considerando l'importante ruolo svolto da server Web e servizi Web, è fondamentale che gli amministratori sappiano come vengono configurati questi server e servizi. Queste informazioni possono essere restituite utilizzando il comando riportato di seguito:
Get-CsService -WebServer
Altre volte è fondamentale che gli amministratori siano in grado di cambiare la configurazione dei server Web. Ad esempio, potrebbe essere necessario modificare la porta utilizzata per le connessioni HTTP o HTTPS esterne. Le modifiche alle porte come queste (ma anche altre modifiche) possono essere apportate con il cmdlet Set-CsWebServer.
Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Set-CsWebServer in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsWebServer"}
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Identity |
Obbligatorio |
Identità XDS |
Identificatore univoco per il pool di servizi Web. Ad esempio: -Identity "WebServer:atl-cs-001.litwareinc.com". È possibile tralasciare il prefisso "WebServer:" quando si specifica un server Web. Ad esempio: -Identity "atl-cs-001.litwareinc.com". |
AppSharingPortCount |
Facoltativo |
Numero intero |
Numero totale di porte allocate per la condivisione delle applicazioni. Le porte effettive da aprire iniziano dalla porta con il valore configurato per AppSharingPortStart e proseguono per il numero di porte specificato in AppSharingPortCount. Ad esempio, se AppSharingPortStart è impostato su 60000 e AppSharingPortCount è impostato su 100, per la condivisione delle applicazioni saranno utilizzate le porte da 60000 a 60099. Il valore predefinito è 16383. |
AppSharingPortStart |
Facoltativo |
Numero intero |
Prima porta nell'intervallo di porte allocato per la condivisione delle applicazioni. Il valore predefinito è 49152. |
ExternalFqdn |
Facoltativo |
Stringa |
Nome di dominio completo utilizzato per le persone che si connettono al pool di servizi Web dall'esterno della rete interna. Ad esempio: -ExternalFqdn "www.litwareinc.com". |
ExternalHttpPort |
Facoltativo |
Numero intero |
Numero di porta per le connessioni Web esterne effettuate con il protocollo HTTP. Il valore predefinito per la porta è 8080. |
ExternalHttpsPort |
Facoltativo |
Numero intero |
Numero di porta per le connessioni Web esterne effettuate con il protocollo HTTPS. Il valore predefinito per la porta è 4443. |
InternalFqdn |
Facoltativo |
Stringa |
Nome di dominio completo dei servizi per dispositivi mobili. Il parametro InternalFqdn deve essere accessibile solo dall'interno del firewall dell'organizzazione. |
McxSipExternalListeningPort |
Facoltativo |
Numero intero |
Porta di attesa esterna per il servizio per dispositivi mobili. |
McxSipPrimaryListeningPort |
Facoltativo |
Numero intero |
Porta di attesa interna per il servizio per dispositivi mobili. |
PrimaryHttpPort |
Facoltativo |
Numero intero |
Numero di porta per le connessioni Web interne effettuate con il protocollo HTTP. Il valore predefinito per la porta è 80. |
PrimaryHttpsPort |
Facoltativo |
Numero intero |
Numero di porta per le connessioni Web interne effettuate con il protocollo HTTPS. Il valore predefinito per la porta è 443. |
PublishedExternalHttpsPort |
Facoltativo |
Numero intero |
Porta esterna per il servizio per dispositivi mobili. |
PublishedPrimaryHttpsPort |
Facoltativo |
Numero intero |
Porta interna per il servizio per dispositivi mobili. |
ReachExternalPsomServerPort |
Facoltativo |
Numero intero |
Numero della porta esterna per il protocollo PSOM (Persistent Shared Object Model), un protocollo di Microsoft utilizzato per le conferenze. Il numero di porta predefinito è 8061. |
ReachPrimaryPsomServerPort |
Facoltativo |
Numero intero |
Numero della porta primaria per il protocollo PSOM (Persistent Shared Object Model), un protocollo di Microsoft utilizzato per le conferenze. Il numero di porta predefinito è 8060. |
UserServer |
Facoltativo |
Stringa |
ID di servizio per il pool di servizi utente associato al pool di servizi Web. Ad esempio: -UserServer "UserServer:atl-cs-001.litwareinc.com". |
Force |
Facoltativo |
Parametro opzionale |
Consente di evitare la visualizzazione di qualunque messaggio di errore non grave che potrebbe essere generato nel corso dell'esecuzione del comando. |
WhatIf |
Facoltativo |
Parametro opzionale |
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente. |
Confirm |
Facoltativo |
Parametro opzionale |
Viene visualizzata una richiesta di conferma prima di eseguire il comando. |
Tipi di input
Nessuno. Set-CsWebServer non accetta l'input da pipeline.
Tipi restituiti
Nessuno. Set-CsWebServer modifica invece le istanze dell'oggetto Microsoft.Rtc.Management.Xds.DisplayWebServer.
Esempio
-------------------------- Esempio 1 ------------------------
Set-CsWebServer -Identity "WebServer:atl-cs-001.litwareinc.com" -PrimaryHttpPort 89
Con il comando mostrato nell'esempio 1 viene modificato PrimaryHttpPort per un singolo pool di servizi Web, quello con identità WebServer:atl-cs-001.litwareinc.com. In questo esempio la porta viene impostata su 89.
-------------------------- Esempio 2 ------------------------
Get-CsService -WebServer | ForEach-Object {Set-CsWebServer -Identity $_.Identity -PrimaryHttpPort 89}
Il comando mostrato nell'esempio 2 è una variazione del comando mostrato nell'esempio 1. Questa volta PrimaryHttpPort viene modificato per tutti i pool di servizi Web nell'organizzazione. Per eseguire questa operazione, il comando utilizza per prima cosa Get-CsService e il parametro WebServer per restituire una raccolta di tutti i pool di servizi Web attualmente in uso. La raccolta viene quindi inviata tramite pipe al cmdlet ForEach-Object, che recupera ogni pool nella raccolta e imposta PrimaryHttpPort sulla porta 89. I dati devono essere inviati tramite pipe a ForEach-Object in quanto il cmdlet Set-CsWebServer non può accettare dati inviati tramite pipeline.