Auf Englisch lesen

Teilen über


Schnellstart: Erstellen einer Confidential Ledger-Instanz mit Azure PowerShell

Azure Confidential Ledger ist ein Clouddienst, der einen Speicher mit hoher Integrität für vertrauliche Datenprotokolle und Datensätze bietet, für die Daten intakt bleiben müssen. In diesem Schnellstart verwenden Sie Azure PowerShell, um eine Confidential Ledger-Instanz zu erstellen, ihre Eigenschaften anzuzeigen und zu aktualisieren und sie zu löschen. Weitere Informationen zu Azure Confidential Ledger und Beispiele dafür, was in einer Confidential Ledger-Instanz gespeichert werden kann, finden Sie unter Informationen zu Microsoft Azure Confidential Ledger.

Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

Azure Cloud Shell

Azure hostet Azure Cloud Shell, eine interaktive Shell-Umgebung, die Sie über Ihren Browser nutzen können. Sie können entweder Bash oder PowerShell mit Cloud Shell verwenden, um mit Azure-Diensten zu arbeiten. Sie können die vorinstallierten Befehle von Cloud Shell verwenden, um den Code in diesem Artikel auszuführen, ohne etwas in Ihrer lokalen Umgebung installieren zu müssen.

Starten von Azure Cloud Shell:

Option Beispiel/Link
Wählen Sie rechts oben in einem Code- oder Befehlsblock die Option Ausprobieren aus. Durch die Auswahl von Ausprobieren wird der Code oder Befehl nicht automatisch in Cloud Shell kopiert. Screenshot: Beispiel von „Jetzt testen“ für Azure Cloud Shell.
Rufen Sie https://shell.azure.com auf, oder klicken Sie auf die Schaltfläche Cloud Shell starten, um Cloud Shell im Browser zu öffnen. Schaltfläche zum Starten von Azure Cloud Shell.
Wählen Sie im Azure-Portal rechts oben im Menü die Schaltfläche Cloud Shell aus. Screenshot: Schaltfläche „Cloud Shell“ im Azure-Portal

So verwenden Sie Azure Cloud Shell:

  1. Starten Sie Cloud Shell.

  2. Wählen Sie die Schaltfläche Kopieren für einen Codeblock (oder Befehlsblock) aus, um den Code oder Befehl zu kopieren.

  3. Fügen Sie den Code oder Befehl mit STRG+UMSCHALT+V unter Windows und Linux oder CMD+UMSCHALT+V unter macOS in die Cloud Shell-Sitzung ein.

  4. Drücken Sie die EINGABETASTE, um den Code oder Befehl auszuführen.

In diesem Schnellstart erstellen Sie eine Confidential Ledger-Instanz mit Azure PowerShell. Wenn Sie PowerShell lokal installieren und verwenden möchten, müssen Sie für dieses Tutorial mindestens die Version 1.0.0 des Azure PowerShell-Moduls verwenden. Geben Sie $PSVersionTable.PSVersion ein, um die Version zu ermitteln. Wenn Sie ein Upgrade ausführen müssen, finden Sie unter Installieren des Azure PowerShell-Moduls Informationen dazu. Wenn Sie PowerShell lokal ausführen, müssen Sie auch Login-AzAccount ausführen, um eine Verbindung mit Azure herzustellen.

Voraussetzungen

Erstellen einer Ressourcengruppe

Eine Ressourcengruppe ist ein logischer Container, in dem Azure-Ressourcen bereitgestellt und verwaltet werden. Erstellen Sie mit dem Azure PowerShell-Cmdlet New-AzResourceGroup eine Ressourcengruppe mit dem Namen myResourceGroup am Standort eastus.

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

Abrufen von Prinzipal-ID und Mandanten-ID

Verwenden Sie Ihre Prinzipal-ID von Microsoft Entra (auch als Objekt-ID bezeichnet), um eine Confidential Ledger-Instanz zu erstellen. Um Ihre Prinzipal-ID abzurufen, verwenden Sie das Azure PowerShell-Cmdlet Get-AzADUser mit dem Flag -SignedIn:

Azure PowerShell
Get-AzADUser -SignedIn

Das Ergebnis wird unter „Id“ aufgeführt und hat das Format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Erstellen einer Confidential Ledger-Instanz

Verwenden Sie das Azure PowerShell-Cmdlet New-AzConfidentialLedger, um in Ihrer neuen Ressourcengruppe eine Confidential Ledger-Instanz zu erstellen.

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

Bei erfolgreicher Ausführung werden die Eigenschaften des neu erstellten Ledgers zurückgegeben. Notieren Sie sich den ledgerUri. Im obigen Beispiel ist dieser URI "https://myledger.confidential-ledger.azure.com".

Sie benötigen diesen URI, um Transaktionen mit der Confidential Ledger-Instanz auf Datenebene auszuführen.

Anzeigen und Aktualisieren der Eigenschaften Ihrer Confidential Ledger-Instanz

Sie können die der neu erstellten Confidential Ledger-Instanz zugeordneten Eigenschaften mit dem Azure PowerShell-Cmdlet Get-AzConfidentialLedger anzeigen.

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

Verwenden Sie zum Aktualisieren der Eigenschaften einer Confidential Ledger-Instanz das Azure PowerShell-Cmdlet Update-AzConfidentialLedger. Führen Sie zum Aktualisieren Ihres Ledgers, um Ihre Rolle in „Leser“ zu ändern, z. B. Folgendes aus:

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

Wenn Sie Get-AzConfidentialLedger erneut ausführen, können Sie sehen, dass die Rolle aktualisiert wurde.

JSON
"ledgerRoleName": "Reader",

Bereinigen von Ressourcen

Andere Schnellstartanleitungen und Tutorials in dieser Sammlung bauen auf dieser Schnellstartanleitung auf. Falls Sie mit weiteren Schnellstartanleitungen und Tutorials fortfahren möchten, sollten Sie die Ressourcen nicht bereinigen.

Wenn die Ressourcengruppe und alle zugehörigen Ressourcen nicht mehr benötigt werden, können Sie sie mit dem Azure PowerShell-Cmdlet Remove-AzResourceGroup entfernen.

Azure PowerShell
Remove-AzResourceGroup -Name "myResourceGroup"

Nächste Schritte

In diesem Schnellstart haben Sie mithilfe von Azure PowerShell eine Confidential Ledger-Instanz erstellt. Weitere Informationen zu Azure Confidential Ledger und zur Integration in Ihre Anwendungen finden Sie in den folgenden Artikeln: