Set-CsRegistrar

Enables you to modify the properties of one or more Registrars. Registrars are used to authenticate logon requests and to maintain information about user status and availability. This cmdlet was introduced in Lync Server 2010.

Syntax

Set-CsRegistrar
   [[-Identity] <XdsGlobalRelativeIdentity>]
   [-ArchivingServer <String>]
   [-BackupRegistrar <String>]
   [-EdgeServer <String>]
   [-EnableAutomaticFailover <Boolean>]
   [-FailbackDetectionInterval <TimeSpan>]
   [-FailureDetectionInterval <TimeSpan>]
   [-MonitoringServer <String>]
   [-SipPort <UInt16>]
   [-UserServer <String>]
   [-WebPort <UInt16>]
   [-WebServer <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [-Registrar <String>]
   [-SipHealthPort <UInt16>]
   [-SipServerTcpPort <UInt16>]
   [-ArchivingDatabase <String>]
   [-LyssWcfMtlsPort <UInt16>]
   [-MirrorArchivingDatabase <String>]
   [-MirrorMonitoringDatabase <String>]
   [-MonitoringDatabase <String>]
   [-WinFabClientConnectionPort <UInt16>]
   [-WinFabFederationPort <UInt16>]
   [-WinFabIPCPort <UInt16>]
   [-WinFabLeaseAgentPort <UInt16>]
   [-WinFabReplicationPort <UInt16>]
   [-XmppGatewaySipPort <UInt16>]
   [<CommonParameters>]

Description

The Registrar is perhaps the most important component in Skype for Business Server; without a Registrar, users would not be able to log on to the system and Skype for Business Server would not be able to keep track of users and their current status. When a user logs on to Skype for Business Server, the endpoint the user is logging on from (be it a computer, a mobile phone, or some other device) sends a REGISTER request to the registration server; in turn the server responds by challenging the client device for authentication credentials. If the client passes the challenge (that is, if the client presents a valid set of credentials), then the user is authenticated and endpoint information such as IP address, port and user name is logged in the registration database. When a user logs off, this information is then removed from the database. In between log on and log off, the Registrar keeps status information up-to-date and helps to route messages to and from the user.

The Set-CsRegistrar cmdlet provides a way for you to modify the properties of one or more Registrars in your organization. These modifications include changing port settings as well as specifying the action that should be taken if a Registrar should become unavailable.

Examples

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

Set-CsRegistrar -Identity "Registrar:atl-cs-001.litwareinc.com" -SipPort 5072

The command shown in Example 1 sets the SIP port for the Registrar Registrar:atl-cs-001.litwareinc.com to 5072.

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

Get-CsService -Registrar | ForEach-Object {Set-CsRegistrar -Identity $_.Identity -SipPort 5072}

Example 2 sets the SIP port for all the Registrars in the organization to 5072. To do this, the command first uses the Get-CsService cmdlet and the Registrar parameter to return a collection of all the Registrars currently in use. This collection is then piped to the ForEach-Object cmdlet, which takes each Registrar in the collection and runs the Set-CsRegistrar cmdlet in order to change the SIP port to 5072.

-------------------------- Example 3 --------------------------

Set-CsRegistrar -Identity "Registrar:atl-cs-001.litwareinc.com" -BackupRegistrar "Registrar:dublin-cs-001.litwareinc.com" -EnableAutomaticFailover $True

Example 3 configures both a backup Registrar (BackupRegistrar) and automatic failover (EnableAutomaticFailover) for the Registrar Registrar:atl-cs-001.litwareinc.com.

Parameters

-ArchivingDatabase

Service Identity of the database used by the Archiving service.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-ArchivingServer

Service location of the Archiving Server to be associated with the Registrar. For example:

-ArchivingServer "ArchivingServer:atl-cs-001.litwareinc.com"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-BackupRegistrar

Service location of the Registrar to be used if this Registrar is not available. For example:

-BackupRegistrar "Registrar:dublin-cs-001.litwareinc.com"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-Confirm

Prompts you for confirmation before executing the command.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-EdgeServer

Service location of the Edge Server to be associated with the Registrar. For example:

-EdgeServer "EdgeServer:atl-edge-001.litwareinc.com"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-EnableAutomaticFailover

If True, the backup Registrar will be employed any time the primary Registrar is unavailable. If False, the backup Registrar will not be used if the primary Registrar is not available.

This parameter also affects users who have registered with a backup Registrar. If this parameter is set to True, then those users will be dropped from the backup Registrar and re-registered on the primary Registrar if and when that Registrar becomes available.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-FailbackDetectionInterval

Specifies the amount of time that the system will wait before checking to see if a Registrar that had become unavailable is now available. If you have set EnableAutomaticFailover to True, the system will "failover" to the backup Registrar any time a Registrar becomes unavailable. That simply means that the system will take users who are logged-on to the failed Registrar and attempt to log them on to the backup Registrar.

The FailbackDetectionInterval property specifies the amount of time that the system will wait before checking to see if the original Registrar is available again. If so, Skype for Business Server will then attempt to "failback" to that Registrar. Failback simply means reverting back to the Registrar initially in use; in other words, logging users back on to their original Registrar.

Note that failback is an automated process only. You cannot manually failback from one Registrar to another.

The detection interval can be set to any value between 30 seconds and 84,400 seconds (24 hours); specify the time span using the format hours:minutes:seconds. For example, this sets the interval to 1 hour and 15 minutes:

-FailbackDetectionInterval 01:15:00

This parameter cannot be used unless you have specified a backup Registrar.

Type:TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-FailureDetectionInterval

Specifies the time interval that the system will wait before deciding that a Registrar is unavailable. If EnableAutomaticFailover has been set to True, the system will then attempt to log users on to the backup Registrar instead.

The detection interval can be set to any value between 30 seconds and 84,400 seconds (24 hours); specify the time span using the format hours:minutes:seconds. For example, this sets the interval to 1 hour and 15 minutes:

-FailureDetectionInterval 01:15:00

This parameter cannot be used unless you have specified a backup Registrar.

Type:TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-Force

Suppresses the display of any non-fatal error message that might occur when running the command.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-Identity

Service location of the Registrar to be modified. For example:

-Identity "Registrar:atl-cs-001.litwareinc.com"

Note that you can leave off the prefix "Registrar:" when specifying a Registrar. For example:

-Identity "atl-cs-001.litwareinc.com"

Type:XdsGlobalRelativeIdentity
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-LyssWcfMtlsPort

Port used by the Lync Storage Service (LYSS). The default value is 5077.

Type:UInt16
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-MirrorArchivingDatabase

Service Identity of the mirror database used by the Archiving service.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-MirrorMonitoringDatabase

Service Identity of the mirror database used by the Monitoring service.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-MonitoringDatabase

Service Identity of the monitoring database associated with the Registrar.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-MonitoringServer

Service location of the Monitoring Server to be associated with the Registrar. For example:

-MonitoringServer "MonitoringServer:atl-cs-001.litwareinc.com"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-Registrar

Service location of the Registrar.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-SipHealthPort

Port used for monitoring server health.

Type:UInt16
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-SipPort

Port used for SIP (Session Initiation Protocol) traffic.

Type:UInt16
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-SipServerTcpPort

SIP listening port. The default value is 5060.

Type:UInt16
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-UserServer

Service location of the User Services server to be associated with the Registrar. For example:

-UserServer "UserServer:atl-cs-001.litwareinc.com"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-WebPort

Port used for communicating with Web servers.

Type:UInt16
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-WebServer

Service location of the Web Server to be associated with the Registrar. For example:

-WebServer "WebServer:atl-cs-001.litwareinc.com"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-WhatIf

Describes what would happen if you executed the command without actually executing the command.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-WinFabClientConnectionPort

Port used for client connections to Windows Fabric. The default value is 5092.

Type:UInt16
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-WinFabFederationPort

Port used for Windows Fabric federation. Federation refers to the process by which Windows fabric routes messages. The default value is 5090.

Type:UInt16
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-WinFabIPCPort

Port used by Windows Fabric for inter-process communication (IPC). IPC is a technology that allows for multiple threads in a process to exchange data. The default value is 5093.

Type:UInt16
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-WinFabLeaseAgentPort

Port used by the Windows Fabric lease agent. Lease agents are used to interact with the kernel level lease driver. The default value is 5091.

Type:UInt16
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-WinFabReplicationPort

Port used for Windows Fabric replication. Skype for Business Server uses Windows Fabric to replicate conference directories to all the Front End servers within a Registrar pool. The default value is 5094.

Type:UInt16
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

-XmppGatewaySipPort

Port used by the XMPP gateway associated with the Registrar. The extensible Messaging and Presence Protocol (XMPP) is an open-standard communications protocol for exchanging messages using XML. An allowed partner is an IM and presence provider whose users are allowed to exchange instant messages and presence information with your Skype for Business Server users. The default value is 5098.

Type:UInt16
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019

Inputs

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

Outputs

The Set-CsRegistrar cmdlet does not return any objects or values. Instead, the command modifies existing instances of the Microsoft.Rtc.Management.Xds.DisplayRegistrar object.