Web API データ操作のサンプル (PowerShell)
この記事では、PowerShell を使用した WebAPI サンプルに関する一般的な理解を提供します。 現在サンプルは 1 つだけですが、さらに追加する予定です。 各サンプルは、Microsoft Dataverse Web API のさまざまな部分に注目しますが、それらはすべて、この記事で説明されている類似したプロセスと構造をフォローします。
PowerShell を使用した Web API サンプル
次のサンプルは、ここで説明されるパターンを使用します:
サンプル | サンプル グループ | Description |
---|---|---|
Web API 基本操作のサンプル (PowerShell) | Web API Operations 操作のサンプル | Dataverse テーブル行 (エンティティ レコード) の作成、取得、更新、削除、関連付け、および関連付け解除の各操作を実行する方法を説明します。 |
現時点では利用不可 | Web API クエリ データのサンプル | OData v4 クエリ構文と機能および Dataverse クエリ機能を使用する方法を説明します。 定義済みクエリに関する作業の例を含み、FetchXML を使用してクエリを実行します。 |
現時点では利用不可 | Web API 条件付き演算サンプル | ETag の条件を指定する条件付き演算の実行方法を示します。 |
現時点では利用不可 | Web API 機能およびアクションのサンプル | ユーザー定義アクションを含む、バインドされた関数とバインドされていない関数およびアクションの使用方法を説明します。 |
Web API テーブル スキーマ操作サンプル (PowerShell) | Web API テーブル スキーマ操作サンプル | Dataverse スキーマまたはメタデータを変更する選択した演算の実行方法を示します。 |
前提条件
これらのサンプルを実行する前に、これらのサンプルで使用される概念とパターンについて説明した次の記事を読む必要があります。
- クイックスタート PowerShell と Visual Studio Code を使った Web API
- PowerShell と Visual Studio Code と Dataverse Web API を使用する
これらのサンプルには同じ前提条件があります。
以下をインストールするか、インストールされていることを確認する
Visual Studio Code をインストールします。 Visual Studio Code をダウンロードする を参照してください
Visual Studio Code 用の PowerShell をインストールします。 Visual Studio Code 用 PowerShell を参照してください
PowerShell 7.4 移行をインストールします。 Windows、Linux、macOS に PowerShell をインストールする を参照します
Az PowerShell モジュール バージョン 11.1.0 以降をインストールします。 Azure PowerShell をインストールする方法 を参照します
既存のインストールを最新のバージョンに更新 するには、
Update-Module -Name Az -Force
を使います
インストールを検証する
Visual Studio Code を開きます。
ターミナル メニューで、新規ターミナル を選択します。
Visual Studio Code ナビゲーション ウィンドウで、PowerShell 拡張子の アイコンを選択します。
Visual Studio Code ターミナル ウィンドウで、次のスクリプトをコピーして貼り付けます。
Write-Host 'PowerShell Version:'$PSVersionTable.PSVersion.ToString() Write-Host 'PowerShell Az version:'(Get-InstalledModule Az).Version
Enter キーを押します。 出力は、次の例のようになります。
PowerShell Version: 7.4.0 PowerShell Az version: 11.1.0
このような結果が表示されない場合は、前提条件をインストールまたは更新してください。
さらに必要なこと
- Dataverse 環境に有効なユーザー アカウント
- 接続に使用したい Dataverse 環境への URL。 検索方法については、開発者向けリソースを表示 をご覧ください。 次のようになります:
https://yourorg.crm.dynamics.com/
、これはyourorg.crm
が異なります。 - PowerShell スクリプト言語の基本的な解釈
参照
Dataverse Web API の使用
クイックスタート PowerShell と Visual Studio Code を使った Web API
Dataverse Web API で PowerShell と Visual Studio Code を使う
Web API のサンプル
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。