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) に接続される電話機、FAX 機器、モデム、およびテレタイプ/聴覚障碍者用文字電話デバイス (TTY/TTD) などがあります。エンタープライズ VoIP (Microsoft が提供するボイス オーバー IP (VoIP) ソリューション) を利用するデバイスとは異なり、アナログ デバイスでは情報を送信するのにデジタル パケットは使用されません。代わりに、連続信号を使用して情報が送信されます。"アナログ デバイス" という用語は、この信号が一般にアナログ信号と呼ばれていることに由来します。
管理者がアナログ デバイスを管理できるようにするために、Lync Server 2010 を使用して、アナログ デバイスを Active Directory の連絡先オブジェクトに関連付けます。デバイスを連絡先オブジェクトに関連付けたら、ポリシーとダイヤル プランを連絡先に割り当てることによってそのアナログ デバイスを管理できます。
新しいアナログ デバイスは、New-CsAnalogDevice コマンドレットを使用して作成します。このコマンドレットでは、アナログ デバイスで使用するための新しい連絡先オブジェクトを作成することも、既存の連絡先オブジェクトを新しいデバイスに関連付けることもできます。詳細についてはこのトピックの OU パラメーターおよび DN パラメーターの説明を参照してください。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが New-CsAnalogDevice コマンドレットをローカルで実行することを承認されています。RTCUniversalUserAdmins。特定のサイトや特定の Active Directory 組織単位 (OU) に対してこのコマンドレットを実行する許可は、Grant-CsOUPermission コマンドレットを使用すると割り当てられます。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsAnalogDevice"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
LineUri |
必須 |
文字列 |
アナログ デバイスの電話番号。回線 Uniform Resource Identifier (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 |
必須 |
ブール値 |
アナログ デバイスが FAX 機器の場合は True ($True) に設定します。デバイスが FAX 機器でない場合は 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 に設定して、このデバイスが FAX 機器ではなく電話機であることを表示)、Gateway (ゲートウェイの IP アドレスに設定)、および OU (デバイスの連絡先オブジェクトが作成される Active Directory OU の識別名) パラメーターが使用されています。