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

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，请执行以下操作：

1. 启动 Cloud Shell。

2. 选择代码块（或命令块）上的“复制”按钮以复制代码或命令。

3. 在 Windows 和 Linux 上按下Ctrl+Shift+V，或在 macOS 上按下Cmd+Shift+V，将代码或命令粘贴到 Cloud Shell 会话中。

4. 选择 Enter 以运行代码或命令。

在本快速入门中，你将使用 Azure PowerShell 创建机密账本。 如果选择在本地安装和使用 PowerShell，本教程需要 Azure PowerShell 模块 1.0.0 或更高版本。 键入 $PSVersionTable.PSVersion 以查找版本。 如果需要升级，请参阅安装 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 机密账本概述