Parameters

Analog devices include telephones, fax machines, modems, and teletype/telecommunication device for the deaf (TTY/TDD) devices that are connected to the public switched telephone network (PSTN). Unlike devices that take advantage of Enterprise Voice (the Voice over Internet Protocol (VoIP) solution offered by Microsoft), analog devices do not transmit information by using digital packets. Instead, information is transmitted by using a continuous signal. This signal is commonly referred to as an analog signal; hence the term "analog devices."

In order to enable administrators to manage analog devices, Microsoft Lync Server 2010 lets you associate analog devices with Active Directory contact objects. After a device has been associated with a contact object, you can then manage the analog device by assigning policies and dial plans to the contact.

The Move-CsAnalogDevice cmdlet provides a way for you to move an existing analog device to a new Registrar pool.

Who can run this cmdlet: By default, members of the following groups are authorized to run the Move-CsAnalogDevice cmdlet locally: RTCUniversalUserAdmins. Permissions to run this cmdlet for specific sites or specific Active Directory organizational units (OUs) can be assigned by using the Grant-CsOUPermission cmdlet. To return a list of all the role-based access control (RBAC) roles this cmdlet has been assigned to (including any custom RBAC roles you have created yourself), run the following command from the Windows PowerShell prompt:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Move-CsAnalogDevice"}

String. Move-CsAnalogDevice accepts a pipelined string value that represents the Identity of the analog device.

By default, Move-CsAnalogDevice does not return any objects or values. However, if you include the PassThru parameter, the cmdlet will return instances of the Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact object.

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

	Copy Code
Move-CsAnalogDevice -Identity "CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com" -Target atl-cs-001.litwareinc.com

The command shown in Example 1 moves the analog device with the Identity CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com to the Registrar pool atl-cs-001.litwareinc.com.

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

	Copy Code
Get-CsAnalogDevice | Where-Object {$_.DisplayName -eq "Building 14, Room 142"} | Move-CsAnalogDevice -Target atl-cs-001.litwareinc.com

In Example 2, the analog device that has the Active Directory display name, "Building 14, Room 142", is moved to the Registrar pool atl-cs-001.litwareinc.com. To do this, Get-CsAnalogDevice is first called without any parameters in order to return a collection of all the analog devices currently in use in the organization. This collection is then piped to the Where-Object cmdlet, which picks out all the devices that have the display name "Building 14, Room 142". That filtered collection is then piped to Move-CsAnalogDevice, which moves all of the devices in the collection to the Registrar pool atl-cs-001.litwareinc.com.

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

	Copy Code
Get-CsAnalogDevice | Where-Object {$_.DisplayName -like "Building 14*"} | Move-CsAnalogDevice -Target atl-cs-001.litwareinc.com

The preceding command moves all of the analog devices that have a display name that begins with the string value "Building 14". To carry out this task, the command first calls Get-CsAnalogDevice to return a collection of all the analog devices currently in use in the organization. This collection is then piped to the Where-Object cmdlet, which selects all the devices that have a display name that begins with the string value "Building 14". The filtered collection is then piped to Move-CsAnalogDevice, which moves each device in the collection to the Registrar pool atl-cs-001.litwareinc.com.

Other Resources