Move-CsAnalogDevice
トピックの最終更新日: 2012-03-23
1 つまたは複数のアナログ デバイスを新しいレジストラー プールに移動します。アナログ デバイスとは、公衆交換電話網 (PSTN) に接続される電話機または他のデバイスです。
構文
Move-CsAnalogDevice -Identity <UserIdParameter> -Target <Fqdn> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Force <SwitchParameter>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-WhatIf [<SwitchParameter>]]
解説
アナログ デバイスには、公衆交換電話網 (PSTN) に接続される電話機、FAX 機器、モデム、およびテレタイプ/聴覚障碍者用文字電話 (TTY/TDD) デバイスが含まれます。エンタープライズ VoIP (Microsoft が提供するボイス オーバー IP (VoIP) ソリューション) を利用するデバイスとは異なり、アナログ デバイスでは、情報はデジタル パケットを使用して送信されません。代わりに、連続信号を使用して送信されます。"アナログ デバイス" という用語は、この信号が一般にアナログ信号と呼ばれていることに由来します。
管理者がアナログ デバイスを管理できるようにするには、Microsoft Lync Server 2010 を使用することにより、アナログ デバイスを Active Directory の連絡先オブジェクトに関連付けることができます。デバイスを連絡先オブジェクトに関連付けたら、ポリシーとダイヤル プランを連絡先に割り当てることによってそのアナログ デバイスを管理できます。
Move-CsAnalogDevice コマンドレットは、既存のアナログ デバイスを新しいレジストラー プールに移動する方法を提供します。
このコマンドレットを実行できるメンバー。既定では、次のグループのメンバーは Move-CsAnalogDevice コマンドレットのローカル実行を承認されています。RTCUniversalUserAdmins。Grant-CsOUPermission コマンドレットを使用して、特定のサイト、または特定の Active Directory 組織単位 (OU) に対してこのコマンドレットを実行するアクセス許可を割り当てることができます。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Move-CsAnalogDevice"}
パラメーター
パラメーター | 必須 | 型 | 説明 |
---|---|---|---|
Identity |
必須 |
UserID |
アナログ デバイスの一意の識別子です。アナログ デバイスは、関連付けられている連絡先オブジェクトの Active Directory 識別名を使用して識別されます。既定では、アナログ デバイスでは、共通名として GUID (グローバル一意識別子) を使用します。したがって、デバイスは通常、次のような ID を持ちます。CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com。 |
Target |
必須 |
FQDN |
アナログ デバイスの移動先であるレジストラー プールの完全修飾ドメイン名 (FQDN) (atl-cs-001.litwareinc.com など) です。レジストラー プールのほか、Target にはホスティング プロバイダーの FQDN を指定することもできます。 |
DomainController |
省略可能 |
FQDN |
アナログ デバイスを移動するために、指定したドメイン コントローラーに接続できるようにします。特定のドメイン コントローラーに接続するには、DomainController パラメーターの後に、コンピューター名 (たとえば、atl-cs-001 など) またはその FQDN (たとえば、atl-cs-001.litwareinc.com など) を指定します。 |
ProxyPool |
省略可能 |
FQDN |
このパラメーターは、Microsoft Lync Online 2010 のみで使用します。このパラメーターを Lync Server の社内実装で使用しないでください。 |
Force |
省略可能 |
スイッチ パラメーター |
このパラメーターが存在する場合は、アナログ デバイスの関連データ (デバイスに割り当てられているポリシーなど) を削除して、このデバイスを移動します。存在しない場合、デバイスは関連データと一緒に移動します。 |
PassThru |
省略可能 |
スイッチ パラメーター |
ユーザー オブジェクトを、移動するユーザー アカウントを表すパイプラインを介して、渡せるようにします。既定では、Move-CsAnalogDevice コマンドレットはパイプラインを介してオブジェクトを渡しません。 |
WhatIf |
省略可能 |
スイッチ パラメーター |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
スイッチ パラメーター |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
文字列。Move-CsAnalogDevice は、アナログ デバイスの Identity を表す、パイプ処理された文字列値の入力を受け入れます。
戻り値の種類
既定では、Move-CsAnalogDevice を実行してもオブジェクトや値が戻されることはありません。ただし、PassThru パラメーターを含める場合は、コマンドレットを実行すると、Microsoft.Rtc.Management.ADConnect.Schema.OCSADAnalogDeviceContact オブジェクトのインスタンスが戻されます。
例
-------------------------- 例 1 ------------------------
Move-CsAnalogDevice -Identity "CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com" -Target atl-cs-001.litwareinc.com
例 1 に示すコマンドを実行すると、Identity CN={ce84964a-c4da-4622-ad34-c54ff3ed361f},OU=Redmond,DC=Litwareinc,DC=com のアナログ デバイスが atl-cs-001.litwareinc.com というレジストラー プールに移動されます。
-------------------------- 例 2 ------------------------
Get-CsAnalogDevice | Where-Object {$_.DisplayName -eq "Building 14, Room 142"} | Move-CsAnalogDevice -Target atl-cs-001.litwareinc.com
例 2 では、Active Directory の表示名が "Building 14, Room 142" であるアナログ デバイスを atl-cs-001.litwareinc.com というレジストラー プールに移動します。これを実行するために、最初にパラメーターを指定せずに Get-CsAnalogDevice を呼び出します。これにより、組織で現在使用されているすべてのアナログ デバイスのコレクションが戻されます。次に、このコレクションは Where-Object コマンドレットにパイプ処理され、表示名が "Building 14, Room 142" であるすべてのデバイスを選び出します。このフィルター処理されたコレクションが Move-CsAnalogDevice にパイプ処理され、コレクション内のすべてのデバイスが atl-cs-001.litwareinc.com というレジストラー プールに移動されます。
-------------------------- 例 3 ------------------------
Get-CsAnalogDevice | Where-Object {$_.DisplayName -like "Building 14*"} | Move-CsAnalogDevice -Target atl-cs-001.litwareinc.com
上のコマンドを実行すると、表示名が "Building 14" という文字列値で始まる、すべてのアナログ デバイスが移動されます。このタスクを実行するため、コマンドはまず Get-CsAnalogDevice を呼び出し、組織で現在使用中のすべてのアナログ デバイスのコレクションを戻します。次に、このコレクションは Where-Object コマンドレットにパイプ処理され、表示名が "Building 14" という文字列値で始まるすべてのデバイスを選択します。このフィルター処理されたコレクションが Move-CsAnalogDevice にパイプ処理され、コレクション内の各デバイスが atl-cs-001.litwareinc.com というレジストラー プールに移動されます。