[This is preliminary documentation and is subject to change. Blank topics are included as placeholders.]

Enables you to modify the properties of one or more Registrar servers. Registrars are used to authenticate logon requests, and to maintain information about user status and availability.

Syntax


Set-CsRegistrar [-Identity <XdsGlobalRelativeIdentity>] [-ArchivingServer <String>] [-BackupRegistrar <String>] [-Confirm [<SwitchParameter>]] [-EdgeServer <String>] [-EnableAutomaticFailover <$true \| $false>] [-FailbackDetectionInterval <TimeSpan>] [-FailureDetectionInterval <TimeSpan>] [-Force <SwitchParameter>] [-MonitoringServer <String>] [-SipHealthPort <UInt16>] [-SipPort <UInt16>] [-SipServerTcpPort <UInt16>] [-UserServer <String>] [-WebPort <UInt16>] [-WebServer <String>] [-WhatIf [<SwitchParameter>]]

Set-CsRegistrar [-Identity <XdsGlobalRelativeIdentity>] [-ArchivingServer <String>] [-BackupRegistrar <String>] [-Confirm [<SwitchParameter>]] [-EdgeServer <String>] [-EnableAutomaticFailover <$true | $false>] [-FailbackDetectionInterval <TimeSpan>] [-FailureDetectionInterval <TimeSpan>] [-Force <SwitchParameter>] [-MonitoringServer <String>] [-SipHealthPort <UInt16>] [-SipPort <UInt16>] [-SipServerTcpPort <UInt16>] [-UserServer <String>] [-WebPort <UInt16>] [-WebServer <String>] [-WhatIf [<SwitchParameter>]]

Parameters

Parameter	Required	Type	Description
Identity	Optional	Xds Identity	Service location of the Registrar to be modified. For example: -Identity "Registrar:atl-cs-001.litwareinc.com".
MonitoringServer	Optional	String	Service location of the Monitoring Server to be associated with the Registrar. For example: -MonitoringServer "MonitoringServer:atl-cs-001.litwareinc.com".
ArchivingServer	Optional	String	Service location of the Archiving Server to be associated with the Registrar. For example: -ArchivingServer "ArchivingServer:atl-cs-001.litwareinc.com".
WebServer	Optional	String	Service location of the Web Server to be associated with the Registrar. For example: -WebServer "WebServer:atl-cs-001.litwareinc.com".
EdgeServer	Optional	String	Service location of the Edge Server to be associated with the Registrar. For example: -EdgeServer "EdgeServer:atl-edge-001.litwareinc.com".
UserServer	Optional	String	Service location of the User Services Server to be associated with the Registrar. For example: -UserServer "UserServer:atl-cs-001.litwareinc.com".
SipPort	Optional	Integer	Port used for SIP (Session Initiation Protocol) traffic.
WebPort	Optional	Integer	Port used for communicating with Web servers.
BackupRegistrar	Optional	String	Service location of the Registrar to be used if this Registrar is not available. For example: -BackupRegistrar "Registrar:dublin-cs-001.litwareinc.com".
EnableAutomaticFailover	Optional	Boolean	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.
FailbackDetectionInterval	Optional	TimeSpan	Specifies the time interval that the system will wait before deciding that the Registrar used to sign on to the system has become unavailable. If specified, the system, will then attempt to "failback" to the backup Registrar. Failback is the ability to switch to a new Registrar if the current Registrar becomes unavailable. 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.
FailureDetectionInterval	Optional	TimeSpan	Specifies the time interval that the system will wait before deciding that a Registrar is unavailable. If specified, the system, will then attempt to log the user on using the backup Registrar. 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.
Force	Optional	Switch Parameter	Suppresses the display of any non-fatal error message that might arise when running the command.
WhatIf	Optional	Switch Parameter	Describes what would happen if you executed the command without actually executing the command.
Confirm	Optional	Switch Parameter	Prompts you for confirmation before executing the command.

Detailed Description

The Registrar is perhaps the most important component in Communications Server 2010; after all, without a Registrar, users would not be able to log on to the system, and Communications Server 2010 would not be able to keep track of users and their current status. When a user logs on to Communications Server 2010 the endpoint the user is logging on from (be it a computer, a cell 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 logon and logoff, 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.

Return Types

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

Examples

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

	Copy Code
Set-CsRegistrar -Identity -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 --------------------------

	Copy Code
Get-CsService -Registrar \| Set-CsRegistrar -SipPort 5072

The preceding command sets the SIP port for all the Registrars in the organization to 5072. To do this, the command first sues Get-CsService and the –Registrar parameter to return a collection of all the Registrars currently in use. This collection is then piped to the Set-CsRegistrar cmdlet, which takes each Registrar in the collection and sets the SIP port to 5072.

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

	Copy Code
Set-CsRegistrar -Identity "Registrar:atl-cs-001.litwareinc.com" -BackupRegistrar Dublin-Registrar-1 -EnableAutomaticFailover $True

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