你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

快速入门：使用 Azure PowerShell 创建机密账本

项目
08/08/2024

Azure 机密账本是一种云服务，可为必须保持不变的敏感数据日志和记录提供高完整性存储。在本快速入门中，你将使用 Azure PowerShell 创建机密账本，查看并更新其属性，以及将其删除。有关 Azure 机密账本的详细信息以及机密账本中可存储哪些内容的示例，请参阅关于 Microsoft Azure 机密账本。

如果没有 Azure 订阅，请在开始之前创建一个免费帐户。

Azure Cloud Shell

Azure 托管 Azure Cloud Shell（一个可通过浏览器使用的交互式 shell 环境）。可以将 Bash 或 PowerShell 与 Cloud Shell 配合使用来使用 Azure 服务。可以使用 Cloud Shell 预安装的命令来运行本文中的代码，而不必在本地环境中安装任何内容。

若要启动 Azure Cloud Shell，请执行以下操作：

选项	示例/链接
选择代码或命令块右上角的“试用”。选择“试用”不会自动将代码或命令复制到 Cloud Shell。
转到 https://shell.azure.com 或选择“启动 Cloud Shell”按钮可在浏览器中打开 Cloud Shell。
选择 Azure 门户右上角菜单栏上的 Cloud Shell 按钮。

若要使用 Azure Cloud Shell，请执行以下操作：

启动 Cloud Shell。
选择代码块（或命令块）上的“复制”按钮以复制代码或命令。
在 Windows 和 Linux 上选择 Ctrl+Shift+V，或在 macOS 上选择 Cmd+Shift+V 将代码或命令粘贴到 Cloud Shell 会话中。
选择“Enter”运行代码或命令。

在本快速入门中，你将通过 Azure PowerShell 创建机密账本。如果选择在本地安装并使用 PowerShell，则本教程需要 Azure PowerShell 模块 1.0.0 或更高版本。键入 $PSVersionTable.PSVersion 即可查找版本。如果需要进行升级，请参阅 Install Azure PowerShell module（安装 Azure PowerShell 模块）。如果在本地运行 PowerShell，则还需运行 Login-AzAccount 以创建与 Azure 的连接。

先决条件

订阅所有者 - 只有在 Azure 订阅上具有所有者权限的用户才能创建机密账本。在继续此快速入门之前，请先确认你具有适当的访问权限。

创建资源组

资源组是在其中部署和管理 Azure 资源的逻辑容器。使用 Azure PowerShell New-AzResourceGroup cmdlet 在 eastus 位置创建一个名为 myResourceGroup 的资源组。

New-AzResourceGroup -Name "myResourceGroup" -Location "EastUS"

获取主体 ID 和租户 ID

若要创建机密账本，请使用 Microsoft Entra 主体 ID（也称为对象 ID）。若要获取主体 ID，请使用 Azure PowerShell Get-AzADUser cmdlet 和 -SignedIn 标志：

Get-AzADUser -SignedIn

结果在“Id”下列出，采用 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 格式。

创建机密账本

使用 Azure PowerShell New-AzConfidentialLedger 命令在新的资源组中创建机密账本。

New-AzConfidentialLedger -Name "myLedger" -ResourceGroupName "myResourceGroup" -Location "EastUS" -LedgerType "Public" -AadBasedSecurityPrincipal @{ LedgerRoleName="Administrator"; PrincipalId="aaaaaaaa-bbbb-cccc-1111-222222222222"; }

操作成功会返回新创建的账本的属性。记下 ledgerUri。在上面的示例中，此 URI 为“https://myledger.confidential-ledger.azure.com"”。

你需要此 URI 来处理来自数据平面的机密账本。

查看并更新你的机密账本属性

可以使用 Azure PowerShell Get-AzConfidentialLedger cmdlet 查看与新创建的机密账本关联的属性。

Get-AzConfidentialLedger -Name "myLedger" -ResourceGroupName "myResourceGroup"

若要更新机密账本的属性，请使用 Azure PowerShell Update-AzConfidentialLedger cmdlet。例如，若要更新账本以将角色更改为“读者”，请运行：

Update-AzConfidentialLedger -Name "myLedger" -ResourceGroupName "myResourceGroup" -Location "EastUS" -LedgerType "Public" -AadBasedSecurityPrincipal @{ LedgerRoleName="Reader"; PrincipalId="aaaaaaaa-bbbb-cccc-1111-222222222222"; }

如果再次运行 Get-AzConfidentialLedger，会看到角色已更新。

"ledgerRoleName": "Reader",

清理资源

本系列中的其他快速入门和教程是在本快速入门的基础上制作的。如果打算继续使用其他快速入门和教程，则可能需要保留这些资源。

如果不再需要资源组及所有相关资源，可使用 Azure PowerShell Remove-AzResourceGroup cmdlet 将其删除。

Remove-AzResourceGroup -Name "myResourceGroup"

后续步骤

在本快速入门中，你使用 Azure PowerShell 创建了机密账本。若要详细了解 Azure 机密账本以及如何将其与应用程序集成，请继续阅读以下文章。

Microsoft Azure 机密账本概述

通过