Creates a new collection of registrar configuration settings. Registrars are used any time a user logs onto (or off of) Microsoft Communications Server 2010. The registrar retrieves location information from the user agent (IP address, port, and user name) and then writes this information to the internal database. This information enables Communications Server to keep track of the status, and whereabouts, of the user.
Syntax
New-CsRegistrarConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-DefaultEndpointExpiration <Int32>] [-EnableDHCPServer <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxEndpointExpiration <Int32>] [-MaxEndpointsPerUser <UInt16>] [-MinEndpointExpiration <Int32>] [-WhatIf [<SwitchParameter>]] |
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Optional |
Xds Identity |
Unique identifier for the registrar configuration settings to be created. To create settings configured at the site scope, use syntax similar to this: -Identity site:Redmond. To create settings at the service level, use syntax like this: -Identity service:Registrar:atl-cs-001.litwareinc.com. Note that a given site or service can only have, at most, a single collection of registrar settings. If you try to create a new collection with the Identity site:Redmond and the Redmond site already hosts a collection of registrar settings then your command will fail. In addition, keep in mind that you cannot create new registrar settings at the global scope. If you want to change values at the global scope, use the Set-CsRegistrarConfiguration cmdlet. |
|
DefaultEndpointExpiration |
Optional |
Integer |
When endpoints log on they have the option of requesting an expiration timeout; this specifies the time interval that an endpoint can remain logged onto the system before it must contact the server and request an extension. The DefaultEndpointExpiration property represents the expiration timeout interval for clients that do not request a specific timeout value. The DefaultEndpointExpiration must be between 300 (5 minutes) and 900 (15 minutes). The default value is 600 (10 minutes). |
|
MaxEndpointExpiration |
Optional |
Integer |
When endpoints log on they have the option of requesting an expiration timeout; this specifies the time interval that an endpoint can remain logged onto the system before it must contact the server and request an extension. The MaxEndpointExpiration property represents the maximum amount of time that clients can be granted. For example, if the maximum time is set to 600 seconds and a client requests a timeout interval of 800 seconds, the client will be given the maximum allowed expiration period: 600 seconds. The MaxEndpointExpiration must be between 300 (5 minutes) and 900 (15 minutes). The default value is 900. |
|
MinEndpointExpiration |
Optional |
Integer |
When endpoints log on they have the option of requesting an expiration timeout; this specifies the time interval that an endpoint can remain logged onto the system before it must contact the server and request an extension. The MinEndpointExpiration property represents the minimum amount of time that clients can be granted. For example, if the minimum time is set to 600 seconds and a client requests a timeout interval of 200 seconds, the client will be given the minimum allowed expiration period: 600 seconds. The MinEndpointExpiration must be between 300 (5 minutes) and 900 (15 minutes). The default value is 300. |
|
MaxEndpointsPerUser |
Optional |
Integer |
Indicates the maximum number of endpoints a user can simultaneously have connected to the system. (For example, a user who is logged on to Communications Server 2010 with both a computer and a cell phone would be using 2 endpoints. MaxEndPointsPerUser must be set to a value between 1 and 64, inclusive. The default value is 8. |
|
EnableDHCPServer |
Optional |
Boolean |
Indicates whether endpoints can use DHCP servers to locate a Registrar. If True, clients will send a DHCP Inform message when they first start; the DHCP server will respond by sending the fully qualified domain name of a Registrar that can be used to log on the user. |
|
InMemory |
Optional |
Switch Parameter |
Creates an object reference without actually committing the object as a permanent change. If you assign the output of this cmdlet called with this parameter to a variable, you can make changes to the properties of the object reference and then commit those changes by calling this cmdlet’s matching Set- cmdlet. |
|
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 would not be able to keep track of users and their current status. When a user logs on to Communications Server 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 CsRegistrarConfiguration cmdlets (are used to help manage endpoints and endpoint subscriptions; the corresponding registrar configuration collections can be applied at the global, site, or service scope. (Service scoped-settings can only be used with the Registrar service.)
The New-CsRegistrarConfiguration cmdlet enables you to create new registrar configuration settings at either the site or the service scope. Note that a given site or service can only have, at most, one such settings collection; if you try to add a new collection to a site or service that already hosts a collection of registrar configuration settings your command will fail. Your command will also fail if you try to create new settings at the global scope.
Return Types
New-CsRegistrarConfiguration creates new instances of the Microsoft.Rtc.Management.WritableConfig.Settings.Registrar.RegistrarSettings object.
Examples
-------------------------- Example 1 --------------------------
 Copy Code |
|
|---|---|
New-CsRegistrarConfiguration -Identity site:Redmond -MaxEndpointsPerUser 4 -EnableDHCPServer $True |
|
The preceding command creates a new collection of registrar configuration settings for the Redmond site (-Identity site:Redmond). In addition to specifying the Identity for the new settings, the command also sets the maximum endpoints per user to 4 (-MaxEndpointsPerUser 4) and enables the use of the DHCP server for client registration (-EnableDHCPServer $True). Note that this command will fail if the Redmond site has already been assigned a collection of registrar configuration settings.
-------------------------- Example 2 --------------------------
| Copy Code |
|
|---|---|
$x = New-CsRegistrarConfiguration -Identity site:Redmond -InMemory $x.MaxEndpointsPerUser = 4 $x.EnableDHCPServer = $True Set-CsRegistrarConfiguration -Instance $x |
|
The commands shown in Example 2 also create a new collection of registrar configuration settings for the Redmond site (-Identity site:Redmond). In this example, however, these settings are initially created in memory only, and are later applied to the site itself.
To carry out this task, the first command uses New-CsRegistrarConfiguration to create a new collection of settings for site:Redmond; the -InMemory parameter is added to the end of the command to ensure that these settings are created in memory only and are not immediately applied to the Redmond site. Because these settings exist only in memory, they must be stored in a variable. In this case, that’s a variable named $x.
In commands 2 and 3 two properties of these new virtual settings (MaxEndpointsPerUser and EnableDHCPServer) are modified. The final command in the example then uses Set-CsRegistrarConfiguration to transform the virtual settings stored in $x into an actual set of registrar configuration settings applied to the Redmond site. If you do not call Set-CsRegistrarConfiguration no new settings will be created for the Redmond site, and your virtual settings will disappear as soon as you terminate your Windows PowerShell session or delete the variable $x.