New-CsAnalogDevice
上次修改主題的時間： 2012-03-23
建立可使用 Microsoft Lync Server 2010 來管理的新類比裝置。類比裝置是指和公用交換電話網路 (PSTN) 連接的電話或其他裝置。
語法
New-CsAnalogDevice -AnalogFax <$true | $false> -Gateway <Fqdn> -LineUri <String> -OU <OUIdParameter> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]
New-CsAnalogDevice -AnalogFax <$true | $false> -DN <ADObjectId> -Gateway <Fqdn> -LineUri <String> -RegistrarPool <Fqdn> [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]
詳細描述
類比裝置包含電話、傳真機、數據機，以及與公用交換電話網路 (PSTN) 連接的聽障人士電傳通訊裝置 (TTY/TDD)。與利用 Enterprise Voice (Microsoft 提供的 Voice over Internet Protocol (VoIP) 解決方案) 的裝置不同，類比裝置不會使用數位封包傳輸資訊；而是使用連續訊號來傳輸資訊。此訊號通常稱做類比訊號，因此這類裝置稱做「類比裝置」。
為了讓系統管理員能夠管理類比裝置，Lync Server 2010 讓您能夠將類比裝置與 Active Directory 連絡人物件產生關聯。在裝置已與連絡人物件產生關聯後，您便可藉由指派原則與撥號對應表至該連絡人，以管理類比裝置。
您可以使用 New-CsAnalogDevice 指令程式來建立新的類比裝置。此指令程式可以建立新的連絡人物件以便與類比裝置搭配使用，或者可將現有的連絡人物件關聯至新裝置。如需詳細資訊，請參閱本主題的 OU 和 DN 參數描述。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 New-CsAnalogDevice Cmdlet：RTCUniversalUserAdmins。可以使用 Grant-CsOUPermission 指令程式，為特定站台或特定 Active Directory 組織單位 (OU) 指派執行此指令程式的權限。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsAnalogDevice"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
LineUri |
必要 |
字串 |
類比裝置的電話號碼。指定線路統一資源識別項 (URI) 時應該採用 E.164 格式，並在開頭加上 "TEL:"首碼。例如：TEL:+14255551297。任何分機號碼都應該新增至線路 URI 的尾端，例如："TEL:+14255551297;ext=51297"。 |
SipAddress |
選用 |
SIP 位址 |
可讓類比裝置與諸如 Microsoft Lync 2010 的 SIP 裝置進行通訊的唯一識別碼 (類似電子郵件地址)。SIP 位址的開頭必須是首碼 "sip:"。例如：sip:bldg14lobby@litwareinc.com。 |
RegistrarPool |
必要 |
字串 |
連絡人物件應隸屬之登錄器集區的完整網域名稱 (FQDN)。例如：-RegistrarPool "atl-cs-001.litwareinc.com"。 |
DisplayName |
選用 |
字串 |
設定類比裝置的 Active Directory 顯示名稱。 |
DisplayNumber |
選用 |
字串 |
在 Lync 2010 中顯示的電話號碼。DisplayNumber 屬性可設為任何您偏好的格式，例如 1-800-555-1234、1-(800)-555-1234、1.800.555.1234 等。 |
AnalogFax |
必要 |
布林值 |
如果類比裝置為傳真機則設為 True ($True)。如果裝置不是傳真機則設為 False ($False)。 |
Gateway |
必要 |
字串 |
表示類比裝置使用之 PSTN 閘道的 IP 位址。 |
OU |
必要 |
Active Directory 辨別名稱 |
連絡人物件應位於其中之 Active Directory 組織單位 (OU) 的辨別名稱。例如：-OU "ou=Redmond,dc=litwareinc,dc=com”。 如果您加入 OU 參數，會在指定的 OU 中建立一個新連絡人，而且該連絡人會自動被指派一個 GUID (全域唯一識別碼) 做為其一般名稱。因此，連絡人物件將具備類似下列的名稱：{ce84964a-c4da-4622-ad34-c54ff3ed361f}。 |
DN |
選用 |
Active Directory 辨別名稱 |
讓您能夠將現有的 Active Directory 連絡人物件關聯至類比裝置。如果您想要將連絡人物件關聯至類比裝置，請使用 DN 參數，後面加上該連絡人的辨別名稱。例如：-DN "cn=Building 14 Lobby,dc=litwareinc,dc=com"。請注意，如果指定的連絡人不存在，命令將會失敗。 您無法在同一個命令中使用 OU 和 DN 參數。 |
PassThru |
選用 |
切換參數 |
傳回代表一般區域電話的物件。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
無。New-CsAnalogDevice 不會接受管線傳送的輸入。
傳回類型
New-CsAnalogDevice 會建立 Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact 物件的新執行個體。
範例
-------------------------- 範例 1 ------------------------
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"
範例 1 所示的命令會利用電話號碼 (LineUri) 1-425-555-6001 來建立新的類比裝置 (請注意，電話號碼必須使用 E.164 格式來指定)。除了 LineUri 參數之外，此命令中使用的其他參數如下：DisplayName (可設定裝置的 Active Directory 顯示名稱)；RegistrarPool (可指定登錄器集區)；AnalogFax (設定為 $False，表示這是電話而非傳真機)；Gateway (設定為閘道的 IP 位址)；以及 OU (應在其中建立裝置連絡人物件之 Active Directory OU 的辨別名稱)。