通过

Web API 基本操作示例（PowerShell）

此 PowerShell 版本 7.4.0 示例演示如何使用 Dataverse Web API 和Visual Studio Code执行常见数据作。 此示例实现了在Web API 基本操作示例中详述的 Dataverse 操作和控制台输出。

在 Github 上查看此示例

此示例使用 Dataverse Web API PowerShell 帮助程序函数 来管理身份验证，并提供可重用的函数来执行常见作。 这些脚本通过点引用方式引用，具体行如下：

. $PSScriptRoot\..\Core.ps1
. $PSScriptRoot\..\TableOperations.ps1
. $PSScriptRoot\..\CommonFunctions.ps1

注释

此示例应适用于 Windows、Linux 和 macOS，但仅在Windows上进行了测试。

先决条件

在运行此示例之前，应阅读以下文章来解释这些示例使用的概念和模式：

这些文章具有相同的先决条件。

安装或验证是否已安装以下内容

验证安装

  1. 打开Visual Studio Code。

  2. 在“终端”菜单中，选择“新终端”。

  3. 在Visual Studio Code导航窗格中，选择 PowerShell 扩展的 图标。

  4. 在Visual Studio Code终端窗口中复制并粘贴以下脚本：

    Write-Host 'PowerShell Version:'$PSVersionTable.PSVersion.ToString()
Write-Host 'PowerShell Az version:'(Get-InstalledModule Az).Version

  5. 按 Enter。 输出应如下所示：

    PowerShell Version: 7.4.0
PowerShell Az version: 11.1.0

如果未看到如下所示的结果，请安装或更新必备组件。

还需要

  • Dataverse 环境的有效用户帐户
  • 要连接到的 Dataverse 环境的 URL。 请参阅 “查看开发人员资源 ”，了解如何查找它。 它看起来如下所示：https://yourorg.crm.dynamics.com/，其中 yourorg.crm 不同。
  • 基本了解 PowerShell 脚本语言

如何运行此示例

  1. 克隆或下载 PowerApps-Samples 存储库。

  2. 使用 Visual Studio Code 打开 BasicOperations.ps1 文件

  3. 编辑此行以使用要连接到的环境的 URL：

    Connect 'https://yourorg.crm.dynamics.com/' # change this

  4. （可选）如果不想删除此示例创建的记录，请将 $deleteCreatedRecords 变量设置为 $false。

  5. 按 F5 运行示例。

  6. 首次运行示例时，会打开一个浏览器窗口。 在浏览器窗口中，输入或选择要用于进行身份验证的凭据。

若要以其他用户身份进行连接，请运行 Disconnect-AzAccount 命令 ，然后重试。

Code

此示例的代码位于： PowerApps-Samples/dataverse/webapi/PS/BasicOperations/BasicOperations.ps1

演示

此示例有五个区域：

第 1 节：基本创建和更新操作

操作：

  • 创建联系人记录。
  • 更新联系人记录。
  • 检索联系人记录。
  • 更新联系人记录的单个属性。
  • 检索联系人记录的单个属性。

第 2 节：创建与另一个记录关联的记录

操作：将新记录关联到现有记录。

操作：在一个操作中创建以下条目：一个帐户、其关联的主要联系人，以及该联系人的待办任务。 这些实体类型具有以下关系：

Accounts
    |---[Primary] Contact (N-to-1)
        |---Tasks (1-to-N)

第 4 节：关联与解除关联记录

操作：

  • 将联系人添加到帐户 contact_customer_accounts 集合。
  • 从帐户 contact_customer_accounts 集合中删除联系人。
  • 使用 systemuserroles_association 集合将安全角色关联到用户。
  • 使用 systemuserroles_association 集合删除用户的安全角色。

第 5 节：删除示例记录

操作：本示例中创建的每条记录均在生成时被添加至列表。 本部分循环访问该列表并删除每条记录。

清理

默认情况下，此示例将删除在其中创建的所有记录。 如果要在示例完成后查看已创建的记录，请将 deleteCreatedRecords 变量更改为该变量 false ，系统会提示你确定是否要删除这些记录。

另请参阅

使用 Dataverse Web API
使用 PowerShell 和 Visual Studio Code 快速入门 Web API
使用 PowerShell 和 Visual Studio Code 搭配 Dataverse Web API
使用 Web API 创建表行
使用 Web API 更新和删除表行
使用 Web API 检索表行
Web API 示例
Web API 基本操作示例

  • Last updated on