Moves an existing conference directory from one pool to another. Conference directories are used to help dial-in conferencing users locate Web conference information.
Syntax
Move-CsConferenceDirectory -Identity <XdsGlobalRelativeIdentity> -TargetPool <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]] |
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Required |
Integer |
Numeric identity of the conference directory to be moved. |
|
TargetPool |
Required |
String |
Fully qualified domain name of the pool where the conference directory is to be moved. For example: -Identity atl-cs-002.litwareinc.com. |
|
Force |
Optional |
Switch Parameter |
When present, moves the conference directory even if the target pool is currently unavailable. By default, Move-CsConferenceDirectory will not move directories if the target pool cannot be contacted. |
|
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
When you create a dial-in conferencing URI, those URIs are assigned a unique SIP address. However, SIP addresses are difficult to translate to devices that are not SIP-aware; for example, a SIP address means nothing to a PSTN (Public Switched Telephone Network) telephone. Because of that, Communications Server uses conference directories as a way to help these devices locate, and connect to, dial-in conferences. This is done by creating a SIP conference directory that is associated with each dial-in conferencing URI, and is identified by an integer value rather than a SIP URI. PSTN telephones and other devices can then use these numbers (rather than a SIP URI) when they connect to conferences; in fact, the directory number is included in the PSTN conference identitification users enter when connecting to a dial-in conference.
From time-to-time you might need to move a conference directory from one pool to another; for example, you decommission a pool and thus need to move all your existing conference directories to a new location. The Move-CsConferenceDirectory cmdlet enables you to move conference directories to a different pool.
Return Types
Removes-CsConferenceDirectory deletes instances of the Microsoft.Rtc.Management.WriteableConfig.Settings.PstnConf.ConferenceDirectories object.
Examples
-------------------------- Example 1 ------------------------
 Copy Code |
|
|---|---|
Move-CsConferenceDirectory -Identity 3 -TargetPool atl-cs-002.litwareinc.com |
|
The command shown in Example 1 moves the conference directory with the Identity 3 to the pool atl-cs-002.litwareinc.com.
-------------------------- Example 2 ------------------------
| Copy Code |
|
|---|---|
Move-CsConferenceDirectory -Identity 3 -TargetPool atl-cs-002.litwareinc.com -Force |
|
The command shown in Example 2 is a variation of the command shown in Example 1. In this case, however, the –Force parameter is included to ensure that the move takes place even if the target pool is currently unavailable.
-------------------------- Example 3 ------------------------
| Copy Code |
|
|---|---|
Get-CsConferenceDirectory | Move-CsConferenceDirectory -TargetPool atl-cs-002.litwareinc.com |
|
The preceding command moves all the existing conference directories to the target pool atl-cs-002.litwareinc.com. To carry out this task the command first uses Get-CsConferenceDirectory to return a collection of all the conference directories currently in use in the organization. This collection is then piped to the Move-CsConferenceDirectory cmdlet, which moves each directory in the collection to the target pool.