Set-CsWebServer

Syntax

Set-CsWebServer
   [[-Identity] <XdsGlobalRelativeIdentity>]
   [-AppSharingPortCount <UInt16>]
   [-AppSharingPortStart <UInt16>]
   [-ExternalFqdn <Fqdn>]
   [-ExternalHttpPort <UInt16>]
   [-ExternalHttpsPort <UInt16>]
   [-PrimaryHttpPort <UInt16>]
   [-PrimaryHttpsPort <UInt16>]
   [-ReachExternalPsomServerPort <UInt16>]
   [-ReachPrimaryPsomServerPort <UInt16>]
   [-UserServer <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [-InternalFqdn <Fqdn>]
   [-PublishedExternalHttpPort <UInt16>]
   [-PublishedExternalHttpsPort <UInt16>]
   [-PublishedPrimaryHttpPort <UInt16>]
   [-PublishedPrimaryHttpsPort <UInt16>]
   [-McxSipExternalListeningPort <UInt16>]
   [-McxSipPrimaryListeningPort <UInt16>]
   [-RmWebSipExternalListeningPort <UInt16>]
   [-RmWebSipPrimaryListeningPort <UInt16>]
   [-SupportConferenceConsoleSipExternalListeningPort <UInt16>]
   [-SupportConferenceConsoleSipPrimaryListeningPort <UInt16>]
   [-UcwaSipExternalListeningPort <UInt16>]
   [-UcwaSipPrimaryListeningPort <UInt16>]
   [-MeetingRoomAdminPortalExternalListeningPort <UInt16>]
   [-MeetingRoomAdminPortalInternalListeningPort <UInt16>]
   [-UcapSipPrimaryListeningPort <UInt16>]
   [-VxmlSipPrimaryListeningPort <UInt16>]
   [<CommonParameters>]

Description

Skype for Business Server makes extensive use of Web servers and web services. For example, Address Book queries can be conducted using web services (the Address Book Query Web service). Skype for Business Server also hosts webpages that enable users to do such things as configure their dial-in conferencing personal identification number (PINs). Considering the important role played by Web servers and web services, it is critical that administrators know how these servers and services are configured. That information that can be returned using the following command:

Get-CsService -WebServer

There are also times where it is critical that administrators be able to change the way their Web servers are configured. For example, you might need to modify the port used for external HTTP or HTTPS connections. Port changes like these (and other modifications) can be made using the Set-CsWebServer cmdlet.

Examples

-------------------------- Example 1 ------------------------

Set-CsWebServer -Identity "WebServer:atl-cs-001.litwareinc.com" -PrimaryHttpPort 89

The command shown in Example 1 changes the PrimaryHttpPort for a single Web Service pool: the pool with the Identity WebServer:atl-cs-001.litwareinc.com. In this example, the port is changed to port number 89.

-------------------------- Example 2 ------------------------

Get-CsService -WebServer | ForEach-Object {Set-CsWebServer -Identity $_.Identity -PrimaryHttpPort 89}

The command shown in Example 2 is a variation of the command shown in Example 1. In this case, the PrimaryHttpPort is modified for all the Web Service pools in the organization. To do this, the command starts off by using the Get-CsService cmdlet and the WebServer parameter to return a collection of all the Web Services pools currently in use. This collection is then piped to the ForEach-Object cmdlet, which takes each pool in the collection and sets the PrimaryHttpPort to port 89. The data must be piped to the ForEach-Object cmdlet because the Set-CsWebServer cmdlet cannot accept pipelined data itself.

Parameters

-AppSharingPortCount

-AppSharingPortStart

-Confirm

-ExternalFqdn

-ExternalHttpPort

-ExternalHttpsPort

-Force

-Identity

-InternalFqdn

-McxSipExternalListeningPort

-McxSipPrimaryListeningPort

-MeetingRoomAdminPortalExternalListeningPort

-MeetingRoomAdminPortalInternalListeningPort

-PrimaryHttpPort

-PrimaryHttpsPort

-PublishedExternalHttpPort

-PublishedExternalHttpsPort

-PublishedPrimaryHttpPort

-PublishedPrimaryHttpsPort

-ReachExternalPsomServerPort

-ReachPrimaryPsomServerPort

-RmWebSipExternalListeningPort

-RmWebSipPrimaryListeningPort

-SupportConferenceConsoleSipExternalListeningPort

-SupportConferenceConsoleSipPrimaryListeningPort

-UcapSipPrimaryListeningPort

-UcwaSipExternalListeningPort

-UcwaSipPrimaryListeningPort

-UserServer

-VxmlSipPrimaryListeningPort

-WhatIf

Inputs

None. The Set-CsWebServer cmdlet does not accept pipelined input.

Outputs

None. Instead, the Set-CsWebServer cmdlet modifies instances of the Microsoft.Rtc.Management.Xds.DisplayWebServer object.

Related Links

• Get-CsService