你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
快速入门：使用 Azure CLI 创建机密账本
Azure 机密账本是一种云服务，可为必须保持不变的敏感数据日志和记录提供高完整性存储。 在本快速入门中，我们使用 Azure CLI 创建机密账本，查看并更新其属性，以及将其删除。
有关 Azure 机密账本的详细信息以及机密账本中可存储哪些内容的示例，请参阅关于 Microsoft Azure 机密账本。
如果没有 Azure 订阅，请在开始之前创建一个 Azure 免费帐户。
先决条件
在 Azure Cloud Shell 中使用 Bash 环境。 有关详细信息，请参阅 Azure Cloud Shell 中的 Bash 快速入门。
如需在本地运行 CLI 参考命令，请安装 Azure CLI。 如果在 Windows 或 macOS 上运行，请考虑在 Docker 容器中运行 Azure CLI。 有关详细信息，请参阅如何在 Docker 容器中运行 Azure CLI。
如果使用的是本地安装，请使用 az login 命令登录到 Azure CLI。 若要完成身份验证过程，请遵循终端中显示的步骤。 有关其他登录选项，请参阅使用 Azure CLI 登录。
出现提示时，请在首次使用时安装 Azure CLI 扩展。 有关扩展详细信息，请参阅使用 Azure CLI 的扩展。
运行 az version 以查找安装的版本和依赖库。 若要升级到最新版本，请运行 az upgrade。
- 订阅所有者 - 只有在 Azure 订阅上具有所有者权限的用户才能创建机密账本。 在继续此快速入门之前，请先确认你具有适当的访问权限。
创建资源组
资源组是在其中部署和管理 Azure 资源的逻辑容器。 使用 az group create 命令在 eastus 位置创建一个名为 myResourceGroup 的资源组 。
az group create --name "myResourceGroup" --location "EastUS"
获取主体 ID
要创建机密账本，你需要 Microsoft Entra 主体 ID（也称为对象 ID）。 若要获取主体 ID，请使用 Azure CLI az ad signed-in-user 命令，并按 objectId 筛选结果：
az ad signed-in-user show --query objectId
结果采用 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx 格式。
创建机密账本
使用 Azure CLI az confidentialledger create 命令在新的资源组中创建机密账本。
az confidentialledger create --name "myLedger" --resource-group "myResourceGroup" --location "EastUS" --ledger-type "Public" --aad-based-security-principals ledger-role-name="Administrator" principal-id="<your-principal-id>"
操作成功会返回新创建的账本的属性。 记下 ledgerUri。 在示例中，此 URI 为“https://myledger.confidential-ledger.azure.com"。
你需要此 URI 来处理来自数据平面的机密账本。
查看并更新你的机密账本属性
可以使用 Azure CLI az confidentialledger show 命令查看与新创建的机密账本关联的属性。
az confidentialledger show --name "myLedger" --resource-group "myResourceGroup"
返回的 JSON 对象显示账本的属性，包括你的角色：
"ledgerRoleName": "Administrator",
若要更新机密账本的属性，请使用 Azure CLI az confidentialledger update 命令。 例如，若要更新账本以将角色更改为“读者”，请运行：
az confidentialledger update --name "myLedger" --resource-group "myResourceGroup" --ledger-type "Public" --aad-based-security-principals ledger-role-name="Reader" principal-id="<your-principal-id>"
如果再次运行 az confidentialledger show，会看到角色已更新。
"ledgerRoleName": "Reader",
清理资源
本系列中的其他快速入门和教程是在本快速入门的基础上制作的。 如果打算继续使用后续的快速入门和教程，则可能需要保留这些资源。
如果不再需要资源组和所有相关的资源，可以使用 Azure CLI az group delete 命令将其删除：
az group delete --name "myResourceGroup"
后续步骤
在本快速入门中，你使用 Azure CLI 创建了机密账本。 若要详细了解 Azure 机密账本以及如何将其与应用程序集成，请继续阅读以下文章。