Set-CsUserAcp
トピックの最終更新日: 2012-03-27
新しい電話会議プロバイダーをユーザーまたはユーザーのグループに追加したり、既にユーザーに割り当てられている既存の電話会議プロバイダーを変更したりします。UNRESOLVED_TOKEN_VAL(ps-intro-in-LS2010)
構文
Set-CsUserAcp -Identity <UserIdParameter> -Domain <String> -Name <String> -ParticipantPasscode <String> -TollNumber <String> [-Confirm [<SwitchParameter>]] [-IsDefault <$true | $false>] [-PassThru <SwitchParameter>] [-TollFreeNumbers <String[]>] [-Url <String>] [-WhatIf [<SwitchParameter>]]
例
例 1
例 1 では Set-CsUserAcp コマンドレットを使用して、新しい電話会議プロバイダーをユーザー Ken Myer に追加します。これを行うために、Identity パラメーターを使用して、変更するユーザー アカウントを示します。さらに、必須パラメーターである TollNumber、ParticipantPassCode、Domain、および Name と、適切なパラメーター値を指定します。
Set-CsUserAcp -Identity "Ken Myer" -TollNumber "14255551298" -ParticipantPassCode 13761 -Domain "fabrikam.com" -Name "Fabrikam ACP"
例 2
例 2 に示すコマンドは、財務部門に勤務しているすべてのユーザーに同じ電話会議プロバイダーを割り当てます。この処理を行うため、このコマンドでは最初に Get-CsUser コマンドレットおよび LdapFilter (このフィルター値には "Department=Finance" を指定) を使用して、財務部門に勤務しているすべてのユーザーのコレクションを戻します。次に、このコレクションを Set-CsUserAcp コマンドレットにパイプ処理し、コレクション内の各ユーザーに同じ電話会議プロバイダー (Fabrikam ACP) を割り当てます。
Get-CsUser -LdapFilter "Department=Finance" | Set-CsUserAcp -TollNumber "14255551298" -ParticipantPassCode 13761 -Domain "fabrikam.com" -Name "Fabrikam ACP"
例 3
例 3 は、電話会議プロバイダー Fabrikam ACP をユーザー Ken Myer に割り当てます。このコマンドでは、TollNumber、ParticipantPassCode、Domain、および Name の指定に加えて、無料電話番号のペアも指定しています。これら 2 つの値を割り当てるには、TollFreeNumbers パラメーターの後に、2 つの電話番号をコンマで区切って指定します。
Set-CsUserAcp -Identity "Ken Myer" -TollNumber "14255551298" -ParticipantPassCode 13761 -Domain "fabrikam.com" -Name "Fabrikam ACP" -TollFreeNumbers "18005551010", "18005551020"
解説
電話会議プロバイダーとは、電話会議サービスを組織に提供するサード パーティの企業です。重要な点は、電話会議プロバイダーを利用すると、社外にいて企業ネットワークまたはインターネットに接続されていないユーザーが、電話会議または会議の音声部分に参加できるようになることです。電話会議プロバイダーは多くの場合、リアルタイム通訳、トランスクリプション、オペレーターによる各電話会議のリアルタイム サポートなど、高度なサービスを含めています。
Lync Server では、電話会議プロバイダーとの完全な統合が可能になっていません。CsUserAcp コマンドレット群により、管理者は電話番号やパスコードを設定したり、ユーザーが会議をスケジュールするたびに電話会議プロバイダーとの統合のために使用できるその他の情報を構成したりできます。ただし、これらのコマンドレットは Lync Server の社内バージョン向けに設計されたものではないので (むしろ、Lync Online のみでの使用が想定されています)、電話会議プロバイダーとの統合に関してはプロパティ値の割り当て以上の追加機能は用意されていません。
電話会議プロバイダーは、Set-CsUserAcp コマンドレットを使用してユーザー アカウントに割り当てることができます (1 人のユーザーを複数の電話会議プロバイダーに割り当てることができます)。Set-CsUserAcp コマンドレットを使用して、既存の電話会議プロバイダーのプロパティを変更することもできます。Set-CsUserAcp コマンドレットを呼び出した場合、このコマンドレットは呼び出しに含まれるパラメーターの情報を使用して、ユーザーに割り当てられている既存の電話会議プロバイダーをチェックします。一致するものが見つかった場合、既存のプロバイダーは変更されます。たとえば、次のコマンドを実行したとします。
Set-CsUserAcp -Identity "Ken Myer" -TollNumber "15554251298" -ParticipantPassCode 13761 -Domain "fabrikam.com" -Name "Fabrikam ACP"
さらに、Ken Myer は、このコマンドで指定されている値と同じ値の TollNumber と Domain を持つ Fabrikam ACP という名前の電話会議プロバイダーに既に割り当てられているとします (つまり、違いは ParticipantPassCode だけです)。この場合、Set-CsUserAcp コマンドレットによって既存の Fabrikam ACP プロバイダーが変更されます。一致するものが見つからない場合は、Ken Myer のユーザー アカウントに新しいプロバイダーが追加されます。
このコマンドレットを実行できるユーザー: 既定では、次のグループのメンバーが、Set-CsUserAcp コマンドレットのローカル実行を承認されています。RTCUniversalUserAdmins。このコマンドレットが割り当てられているすべての役割ベースのアクセス制御 (RBAC) の役割の一覧 (自身が作成したカスタムの RBAC の役割を含む) を戻すには、Windows PowerShell プロンプトから次のコマンドを実行します。
Get-CsAdminRole | Where-Object {$_.Cmdlets -match "Set-CsUserAcp"}
パラメーター
| パラメーター | 必須かどうか | 型 | 説明 |
|---|---|---|---|
Domain |
必須 |
System.String |
電話会議プロバイダーのドメイン名です。次に例を示します。-Domain "fabrikam.com"。 ドメイン名は電話会議プロバイダーが指定します。 |
Identity |
必須 |
Microsoft.Rtc.Management.AD.UserIdParameter |
変更するユーザー アカウントの Identity を指定します。ユーザーの Identity は、以下の 4 つの形式のうちの 1 つを使用して指定できます。1) ユーザーの SIP アドレス、2) ユーザーのユーザー プリンシパル名 (UPN)、3) ドメイン\ログオン形式 (litwareinc\kenmyer など) のユーザーのドメイン名とログオン名、および 4) ユーザーの Active Directory ドメイン サービス (AD DS) 表示名 (Ken Myer など)。ユーザーの Active Directory 識別名を使用してユーザーの Identity を参照することもできます。 表示名をユーザーの Identity として使用する場合は、アスタリスク (*) ワイルドカード文字を使用できます。たとえば ID が "* Smith" の場合、文字列値 " Smith" で終わる表示名を持つすべてのユーザーが戻されます。 |
Name |
必須 |
System.String |
電話会議プロバイダーの名前です。次に例を示します。-Name "Fabrikam Conference Services"。 |
ParticipantPasscode |
必須 |
System.String |
電話会議プロバイダーを使用して電話会議に接続するときに必要なパスコードです。次に例を示します。-PassCode "0712"。 |
TollNumber |
必須 |
System.String |
電話会議で使用されている有料電話番号です。次に例を示します。-TollNumber "14255551298"。 |
Confirm |
省略可能 |
System.Management.Automation.SwitchParameter |
コマンドの実行前に確認メッセージを表示します。 |
IsDefault |
省略可能 |
System.Boolean |
これがユーザーの既定の電話会議プロバイダーであるかどうかを示します。各ユーザーに指定できる既定のプロバイダーは 1 つだけです。 |
PassThru |
省略可能 |
System.Management.Automation.SwitchParameter |
アカウント プロパティの構成対象であるユーザーを表すパイプラインを介して、オブジェクトを渡すことができます。既定では、Set-CsUserAcp コマンドレットはパイプラインを介してオブジェクトを渡さないので、このようなケースでは PassThru パラメーターが必要です。 |
TollFreeNumbers |
省略可能 |
System.String[] |
電話会議で使用されている無料電話番号のコレクションです。次に例を示します。-TollFreeNumbers "18005551298"。複数の無料電話番号を追加するには、個々の番号を次のようにコンマで区切ります。-TollFreeNumber "18005551298", "18005559876"。 |
Url |
省略可能 |
System.String |
たとえば、電話会議プロバイダーの Web の URL です。-Url "http://acp.fabrikam.com"。Web の URL を使用すると、電話会議プロバイダーはユーザーに対して、追加のダイヤルイン電話番号や、電話会議プロバイダーが提供しているサービスに関する情報を掲載しているページを示すことができます。 |
WhatIf |
省略可能 |
System.Management.Automation.SwitchParameter |
実際にコマンドを実行せずに、コマンドの実行結果がわかります。 |
入力の種類
文字列または Microsoft.Rtc.Management.ADConnect.Schema.ADUser オブジェクト。Set-CsUserAcp コマンドレットは、Lync Server が有効になっているユーザー アカウントの ID を表すパイプライン処理された文字列値を受け入れます。このコマンドレットは、Active Directory ユーザー オブジェクトのパイプライン処理されたインスタンスも受け入れます。
戻り値の種類
なし。