Remove-CsUserAcp
トピックの最終更新日: 2012-03-25
ユーザーまたはユーザー グループに対して割り当てられた 1 つ以上の電話会議プロバイダーを削除します。
構文
Remove-CsUserAcp -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-Name <String>] [-ParticipantPasscode <String>] [-PassThru <SwitchParameter>] [-TollNumber <String>] [-WhatIf [<SwitchParameter>]]
解説
電話会議プロバイダーとは、電話会議サービスを組織に提供するサード パーティの企業です。重要な点は、電話会議プロバイダーを利用すると、社外にいて企業ネットワークまたはインターネットに接続されていないユーザーが、電話会議または会議のオーディオ部分に参加できるようになることです。電話会議プロバイダーは多くの場合、リアルタイム通訳、トランスクリプション、オペレーターによる各電話会議のリアルタイム サポートなど、高度なサービスを提供します。
Microsoft Lync Server 2010 では、電話会議プロバイダーとの完全な統合は実現できません。CsUserAcp コマンドレットを使用すると、管理者は電話番号とパスコードを設定し、ユーザーが会議をスケジュール設定するときにいつでも使用できる電話会議プロバイダーの統合に関するその他の情報を構成することができます。ただし、これらのコマンドレットは Lync Server の社内バージョンとして設計されたものではなく (むしろ、主に Microsoft Lync Online 2010 で使用することを想定)、プロパティ値を割り当てる以外には、電話会議プロバイダーを統合するための追加機能は用意されていません。
ユーザーに割り当てたどの電話会議プロバイダーも、後で Remove-CsUserAcp コマンドレットを使用して削除できます。パラメーターを何も指定しないで (変更しようとするユーザー アカウントを表す Identity パラメーターは例外です) Remove-CsUserAcp を呼び出すと、ユーザーに対して割り当てられていたすべての電話会議プロバイダーが削除されます。代わりに、Remove-CsUserAcp にオプションのパラメーターを含めて、選択したプロバイダーをユーザー アカウントから削除することもできます。たとえば、次のコマンドはユーザー アカウント Ken Myer を検索し、Name が "Fabrikam ACP" に等しいすべての電話会議プロバイダーを削除します。
Remove-CsUserAcp –Identity "Ken Myer" –Name "Fabrikam ACP"
電話会議プロバイダーを詳細に制御して削除するには、単純に追加のパラメーターを含めます。たとえば、次のコマンドは Name が "Fabrikam ACP" であり、TollNumber が "14255551298" に等しいすべての電話会議プロバイダーを削除します。
Remove-CsUserAcp –Identity "Ken Myer" –Name "Fabrikam ACP" –TollNumber "14255551298"
このコマンドレットを実行できるメンバー。既定では、次のグループのメンバーが Remove-CsUserAcp コマンドレットのローカル実行を承認されています。RTCUniversalUserAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsUserAcp"}
パラメーター
パラメーター | 必須かどうか | 型 | 説明 |
---|---|---|---|
Identity |
必須 |
ユーザー ID |
電話会議プロバイダーを削除しようとするユーザー アカウントの ID を示します。ユーザーの Identity は、以下の 4 つの形式のうちの 1 つを使用して指定できます。1) ユーザーの SIP アドレス、2) ユーザーのユーザー プリンシパル名 (UPN)、3) ドメイン\ログオン形式 (litwareinc\kenmyer など) のユーザーのドメイン名とログオン名、および 4) ユーザーの Active Directory ドメイン サービス (AD DS) 表示名 (Ken Myer など)。ユーザーの Active Directory 識別名を使用してユーザーの Identity を参照することもできます。 表示名をユーザーの Identity として使用する場合は、アスタリスク (*) ワイルドカード文字を使用できます。たとえば、"* Smith" という Identity は、末尾が " Smith" という文字列値の表示名を持つすべてのユーザーを戻します。 |
Name |
省略可能 |
文字列 |
電話会議プロバイダーの名前です。次に例を示します。-Name "Fabrikam Conference Services"。 |
ParticipantPassCode |
省略可能 |
文字列 |
電話会議プロバイダーを使用して電話会議に接続するときに必要なパスコードです。次に例を示します。-PassCode "0712"。 |
TollNumber |
省略可能 |
文字列 |
電話会議に使用する有料電話番号です。次に例を示します。-TollNumber "14255551298"。 |
PassThru |
省略可能 |
スイッチ パラメーター |
パイプラインを介して、電話会議プロバイダーが削除されるユーザーを表すユーザー オブジェクトを渡すことができます。既定では、Remove-CsUserAcp コマンドレットはパイプラインを介してオブジェクトを渡しません。 |
WhatIf |
省略可能 |
スイッチ パラメーター |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
Confirm |
省略可能 |
スイッチ パラメーター |
コマンドの実行前に確認メッセージを表示します。 |
入力の種類
文字列または Microsoft.Rtc.Management.ADConnect.Schema.ADUser オブジェクト。Remove-CsUserAcp は、Microsoft Lync Server 2010 が有効になっているユーザー アカウントの ID を表す、パイプ処理された文字列値を受け入れます。このコマンドレットは、Active Directory ユーザー オブジェクトのパイプ処理されたインスタンスも受け入れます。
戻り値の種類
なし。
例
-------------------------- 例 1 ------------------------
Remove-CsUserAcp -Identity "Ken Myer"
例 1 のコマンドでは、ユーザー Ken Myer に対して割り当てられたすべての電話会議プロバイダーを削除します。
-------------------------- 例 2 ------------------------
Get-CsUser | Remove-CsUserAcp
例 2 では、Lync Server 2010 が有効になっているすべてのユーザーに対して割り当てられたすべての電話会議プロバイダーを削除できる方法を示します。この処理を行うため、コマンドはまず、Get-CsUser を使用して、Lync Server が有効になっているすべてのユーザーのコレクションを取得します。次に、このコレクションを Remove-CsUserAcp コマンドレットにパイプ処理し、コレクション内の各ユーザーに対して割り当てられたすべての電話会議プロバイダーを削除します。
-------------------------- 例 3 ------------------------
Remove-CsUserAcp -Identity "Ken Myer" -Name "Fabrikam ACP"
例 3 では、Name が"Fabrikam ACP" であるすべての電話会議プロバイダーを、Ken Myer のユーザー アカウントから削除します。
-------------------------- 例 4 ------------------------
Get-CsUserAcp | Where-Object {$_.AcpInfo -match "14255551298"} | Remove-CsUserAcp
上記のコマンドでは、有料電話番号が "14255551298" である電話会議プロバイダーを、電話会議プロバイダーが既に割り当てられているすべてのユーザー アカウントから削除します。このタスクを実行するために、コマンドは最初に Get-CsUserAcp を使用して、すべての自組織ユーザーに割り当てられている電話会議プロバイダーに関する情報を戻します。次に、この情報が Where-Object コマンドレットにパイプ処理されます。これは、AcpInfo プロパティに "14255551298" という電話番号が含まれている (-match) アカウントのみを選択します。次に、フィルターしたコレクションを Remove-CsUserAcp コマンドレットにパイプ処理し、そのコマンドレットはフィルター処理されたコレクション内の各アカウントから、対応する電話会議プロバイダーを削除します。