サンプル: セキュリティ プリンシパル (ユーザーまたはチーム) をキュー (事前バインド) に追加
このサンプルは、ユーザーまたはチームにキューへのアクセス権を与える方法を紹介します。 AddPrincipalToQueueRequest では、キュー メンバーの一覧に指定したプリンシパルが追加されます。 渡されたセキュリティ プリンシパルがチームの場合、キューにチームの各メンバーが追加されます。 サンプルは ここ からダウンロードできます。
このサンプルを実行する方法
すべてのサンプルのローカル コピーを取得してビルドするには、次の手順を実行します。
- サンプル リポジトリをダウンロードまたは複製して、ローカル コピーを用意します。
- (オプション) dataverse/App.config ファイルを編集して、接続先のインスタンスまたは組織を指定した接続文字列を定義します。
- サンプル ソリューションを Visual Studio で開き、F5 キーを押してサンプルを実行します。 Dataverse/App.config 内に接続文字列を指定した後、サンプルを実行すると、その接続情報が使用されます。
dataverse/App.config ファイル内に接続文字列を指定しない場合は、サンプルを実行するたびにダイアログが開き、接続先のインスタンスまたは組織についての情報と、使用する資格情報についての情報を入力する必要があります。 このダイアログには以前の接続がキャッシュされているため、以前に使用した接続を選ぶことができます。
このサンプルの概要
AddPrincipalToQueueRequest メッセージは、キュー メンバーの一覧に指定したプリンシパルが追加する必要があるデータが含まれているシナリオで使用するためのものです。 プリンシパルがチームの場合、キューに各チーム メンバーを追加します。
このサンプルがどのように動作するか
このサンプルの概要 で説明されているシナリオをシミュレートするために、サンプルは次のことを行います。
セットアップ
- 組織の現在のバージョンをチェックします。
Queueメソッドではキュー インスタンスが作成され、プロパティ値が設定されます。 返された GUID は変数で保存されます。QueryExpressionは、チームおよびロールの作成に対する既定の部署を取得します。- サンプルに必要な、新しいチームおよびロールの例を作成します。
prvReadQueueおよびprvAppendToQueue特権を取得します。AddPrivilegeRoleRequestメソッドでは、ロールの例にprvReadQueueおよびprvAppendToQueueが追加されます。
使用方法
AddPrincipalToQueueRequest メソッドでは、キューにチームが追加されます。
クリーンアップ
セットアップ でサンプル データを削除するためのオプションを表示します。 サンプルで作成されるエンティティおよびデータを検証する場合、削除は任意です。 手動でレコードを削除することで同じ結果を得られます。