Set-CsAnalogDevice
トピックの最終更新日: 2012-03-26
Microsoft Lync Server 2010 を使用して管理できるアナログ デバイスのコレクション内の、既存のデバイスを変更します。アナログ デバイスは、公衆交換電話網 (PSTN) に接続されている電話などのデバイスのことです。
構文
Set-CsAnalogDevice -Identity <UserIdParameter> [-AnalogFax <$true | $false>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DisplayNumber <String>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-Gateway <Fqdn>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]
解説
アナログ デバイスには、公衆交換電話網 (PSTN) に接続される電話機、FAX 機器、モデム、およびテレタイプ/聴覚障碍者用文字電話デバイス (TTY/TTD) などがあります。エンタープライズ VoIP (Microsoft が提供するボイス オーバー IP (VoIP) ソリューションのこと) を利用するデバイスとは異なり、アナログ デバイスでは情報を送信するのにデジタル パケットは使用されません。代わりに、連続信号を使用して情報が送信されます。"アナログ デバイス" という用語は、この信号が一般にアナログ信号と呼ばれていることに由来します。
管理者がアナログ デバイスを管理できるようにするために、Lync Server 2010 を使用して、アナログ デバイスを Active Directory の連絡先オブジェクトに関連付けます。デバイスを連絡先オブジェクトに関連付けたら、ポリシーとダイヤル プランを連絡先に割り当てることによってそのアナログ デバイスを管理できます。
Set-CsAnalogDevice コマンドレットを実行すると、アナログ デバイスに関連付けられている連絡先オブジェクトのプロパティを変更することができます。たとえば、連絡先の Active Directory 表示名やそのデバイスに関連付けられている回線 Uniform Resource Identifier (URI) を変更できます。
このコマンドレットを実行できるユーザー:既定では、次のグループのメンバーが Set-CsAnalogDevice コマンドレットをローカルで実行することを承認されています。RTCUniversalUserAdmins。特定のサイトや特定の Active Directory 組織 (OU) に対してこのコマンドレットを実行する許可は、Grant-CsOUPermission コマンドレットを使用すると割り当てられます。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsAnalogDevice"}
パラメーター
パラメーター | 必須かどうか | 型 | 説明 |
---|---|---|---|
Identity |
必須 |
ユーザー ID パラメーター |
変更するアナログ デバイスの一意識別子。アナログ デバイスは、関連付けられている連絡先オブジェクトの Active Directory 識別名 (DN) を使用して識別されます。既定では、アナログ デバイスでは、共通名として GUID (グローバル一意識別子) を使用します。したがって、デバイスは、通常、次のような Identity を持ちます。CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com。つまり、アナログ デバイスをより簡単に変更するには、Get-CsAnalogDevice コマンドレットを使用してアナログ デバイス オブジェクトを返し、次に Set-CsAnalogDevice にそれらのオブジェクトをパイプ処理します。 |
Gateway |
省略可能 |
文字列 |
アナログ デバイスによって使用される PSTN ゲートウェイの IP アドレス。 |
AnalogFax |
省略可能 |
ブール値 |
アナログ デバイスが FAX 機器の場合は True ($True) に設定します。デバイスが FAX 機器でない場合は False ($False) に設定します。 |
LineURI |
省略可能 |
文字列 |
アナログ デバイスの電話番号。回線 URI は、E.164 形式を使用し、先頭に "TEL:" というプレフィックスを付けて指定する必要があります。次に例を示します。TEL: +14255551297。内線番号は回線 URI の末尾に追加する必要があります。次に例を示します。TEL: +14255551297; ext=51297。 |
SipAddress |
省略可能 |
SIP アドレス |
アナログ デバイスを使用して Microsoft Lync 2010 などの SIP デバイスと通信するための一意識別子。SIP アドレスの先頭には、プレフィックス "sip:" を付ける必要があります。次に例を示します。sip:bldg14lobby@litwareinc.com。 |
DisplayName |
省略可能 |
文字列 |
アナログ デバイスの Active Directory 表示名を設定します。 |
DisplayNumber |
省略可能 |
文字列 |
Lync 2010 に表示する電話番号。DisplayNumber プロパティは、希望する書式で設定できます。たとえば、1-800-555-1234、1-(800)-555-1234、1.800.555.1234 などの書式で設定できます。 |
DomainController |
省略可能 |
スイッチ パラメーター |
連絡先情報を変更するために、指定したドメイン コントローラーに接続できるようにします。特定のドメイン コントローラーに接続するには、DomainController パラメーターの後に、コンピューター名 (たとえば、atl-mcs-001 など) またはその完全修飾ドメイン名 (FQDN) (たとえば、atl-mcs-001.litwareinc.com など) を指定します。 |
Enabled |
省略可能 |
True |
True ($True) に設定すると、アナログ デバイスは Lync Server 2010 で使用できます。 |
EnterpriseVoiceEnabled |
省略可能 |
ブール値 |
アナログ デバイスの連絡先オブジェクトでエンタープライズ VoIP (Microsoft が提供する VoIP ソリューション) が有効にされているかどうかを示します。エンタープライズ VoIP を使用すると、標準の電話ネットワークでなくインターネットを使用して電話をかけることができます。 |
PassThru |
省略可能 |
スイッチ パラメーター |
共通領域電話を表すオブジェクトを戻します。 |
WhatIf |
スイッチ パラメーター |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
|
Confirm |
省略可能 |
スイッチ パラメーター |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact オブジェクト。Set-CsAnalogDevice は、パイプライン処理されたアナログ デバイス オブジェクトのインスタンスを受け入れます。
戻り値の種類
既定では、Set-CsAnalogDevice は、値もオブジェクトも戻しません。ただし、PassThru パラメーターを指定した場合、このコマンドレットは Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact オブジェクトのインスタンスを戻します。
例
-------------------------- 例 1 ------------------------
Set-CsAnalogDevice -Identity "CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com" -LineUri "TEL:+14255551298"
上のコマンドを実行すると、CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com という Identity を持つアナログ デバイスの LineUri プロパティの値が変更されます。
-------------------------- 例 2 ------------------------
Get-CsAnalogDevice -Filter {Gateway -eq "192.168.0.240"} | Set-CsAnalogDevice -Gateway "192.168.1.100"
例 2 のコマンドは、現在ゲートウェイ 192.168.0.240 を使用している各アナログ デバイスのゲートウェイを変更します。このタスクを実行するには、Filter パラメーターを指定して Get-CsAnalogDevice を呼び出します。フィルター値 {Gateway -eq "192.168.0.240"} で、ゲートウェイが 192.168.0.240 と等しい (-eq) デバイスのみが戻されます。次に、このフィルター処理されたコレクションを Set-CsAnalogDevice にパイプ処理し、コレクション内の各項目を取得して Gateway プロパティの値を 192.168.1.100 に変更します。