Creates a new analog device that can be managed using Microsoft Communications Server 2010. An analog device is a telephone (or fax machine) that is connected to the Public Switched Telephone Network.
Syntax
New-CsAnalogDevice -LineUri <String> [-SipAddress <String>] -RegistrarPool <Fqdn> [-DisplayName <String>] -AnalogFax -Gateway <Fqdn> -OU <OUIdParameter> [-PassThru] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable] <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>] [-WhatIf] [-Confirm] |
Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
|
LineUri |
Required |
String |
Phone number for the analog device. The line URI should be specified using the E.164 format, and be prefixed by the "TEL:" prefix. For example: TEL:+14255551297. Any extension number should be added to the end of the line URI, for example: TEL:+14255551297; ext=51297. |
|
SipAddress |
Optional |
SIP address |
Unique identifier (similar to an e-mail address) that allows the analog device to communicate with SIP devices such as Microsoft Communicator. The SIP address must be prefaced by the prefix "sip:". For example: sip:bldg14lobby@litwareinc.com. |
|
RegistrarPool |
Required |
String |
Fully qualified domain name of the registrar pool where the contact object should be homed. For example: -RegistrarPool "atl-cs-001.litwareinc.com". |
|
DisplayName |
Optional |
String |
Phone number as displayed in Microsoft Communicator. The DisplayNumber property can be formatted any way you prefer; for example 1-800-555-1234; 1-(800)-555-1234; 1.800.555.1234; etc. |
|
DisplayNumber |
Optional |
String |
Configures the Active Directory display name of the analog device. |
|
AnalogFax |
Required |
Boolean |
Set to True ($True) if the analog device is a fax machine. Set to False ($False) or leave this parameter off altogether if the device is not a fax machine. |
|
Gateway |
Required |
String |
IP address of the PSTN gateway to be used by the analog device. |
|
OU |
Required |
Active Directory distinguished name |
Distinguished name of the Active Directory organizational unit where the contact object should be located. For example: -OU "ou=Redmond,dc=litwareinc,dc=com”. If you include the –OU parameter, a new contact will be created in the specified OU, and the contact will automatically be assigned a GUID (globally unique identifier) as its common name. As a result, the contact object will have a name similar to this: {ce84964a-c4da-4622-ad34-c54ff3ed361f}. If you prefer that your analog devices have more user-friendly names, create a contact object in advance (giving that contact a friendly name) and then use the –DN parameter to create the analog device. You cannot use the –OU and the-DN parameters in the same command. |
|
DN |
Optional |
Active Directory distinguished name |
Enables you to associate an existing Active Directory contact object with the analog device. If you have a contact object you want to associate with an analog device, use the –DN parameter followed by the distinguished name of that contact. For example: -DN "cn=Building 14 Lobby,dc=litwareinc,dc=com". Note that your command will fail if the specified contact does not exist. You cannot use the –OU and the-DN parameters in the same command. |
|
PassThru |
Optional |
Switch Parameter |
Returns an object representing the common area phone. |
|
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
Analog devices include telephones, fax machines, modems, and TTY/TTD (Teletype/Telecommunication Devices for the Deaf) devices that are connected to the Public Switched Telephone Network (PSTN). Unlike devices that take advantage of Enterprise Voice (Microsoft’s implementation of Voice over IP), analog devices do not transmit information using digital packets; instead, information is transmitted using a continuous signal. This signal is commonly referred to as an analog signal; hence the term "analog devices.")
Many organizations still are heavily invested in analog devices. In order to enable administrators to manage analog devices, Microsoft Communications Server 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.
New analog devices are created using the New-CsAnalogDevice cmdlet. This cmdlet can either create new contact objects for use with analog devices or it can associate existing contact objects with a new device. See the –OU and the –DN parameter descriptions for more information.
Return Types
New-CsAnalogDevice creates new instances of the Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact object.
Examples
-------------------------- Example 1 ------------------------
 Copy Code |
|
|---|---|
New-CsAnalogDevice -LineUri tel:+14255556001 -DisplayName "Building 14 Receptionist" -RegistrarPool redmond-Cs-001.litwareinc.com -AnalogFax $False -Gateway 192.168.0.240 -OU "ou=Telecommunications,dc=litwareinc,dc=com" |
|
The command shown in Example 1 creates a new analog device with the phone number (LineUri) 1-425-555-6001. (Note that the phone number must be specified using the E.164 format.) In addition to the -LineUri parameter, the other parameters used in this command are -DisplayName (to set the Active Directory display name of the device); -RegistrarPool (to specify the registrar pool); -AnalogFax (set to $False, to indicate that this is a phone and not a fax machine); -Gateway (set to the IP address of the gateway); and -OU (the distinguished name of the Active Directory OU where the device’s contact object should be created).