Schnellstart: Erstellen eines Microsoft Purview-Kontos (früher Azure Purview) mit .NET SDK

In dieser Schnellstartanleitung verwenden Sie das .NET SDK, um ein Microsoft Purview-Konto (früher Azure Purview) zu erstellen.

Das Microsoft Purview-Governanceportal zeigt Tools wie Microsoft Purview Data Map und Microsoft Purview Data Catalog, mit denen Sie Ihre Datenlandschaft verwalten und steuern können. Durch die Verbindung mit Daten aus Ihren lokalen, Multicloud- und SaaS-Quellen (Software-as-a-Service) erstellt die Microsoft Purview Data Map eine aktuelle Karte Ihrer Informationen. Es identifiziert und klassifiziert vertrauliche Daten und bietet eine End-to-End-Herkunft. Datenconsumer können Daten in Ihrer gesamten Organization ermitteln, und Datenadministratoren können Ihre Daten überwachen, sichern und die richtige Verwendung sicherstellen.

Weitere Informationen zu den klassischen Governancefunktionen von Microsoft Purview finden Sie auf der Übersichtsseite zu Governancelösungen.

Voraussetzungen

• Wenn Sie nicht über ein Azure-Abonnement verfügen, erstellen Sie ein kostenloses Abonnement, bevor Sie beginnen.

• Ein Microsoft Entra-Mandant, der Ihrem Abonnement zugeordnet ist.

• Das Benutzerkonto, das Sie für die Anmeldung bei Azure verwenden, muss ein Mitglied der Rolle "Mitwirkender" oder "Besitzer" oder ein Administrator des Azure-Abonnements sein. Führen Sie die folgenden Schritte aus, um die Berechtigungen anzuzeigen, die Sie im Abonnement haben:

  1. Wechseln Sie zum Azure-Portal
  2. Wählen Sie Ihren Benutzernamen in der oberen rechten Ecke aus.
  3. Wählen Sie die Schaltfläche mit den Auslassungspunkten ("...") aus, um weitere Optionen anzuzeigen.
  4. Wählen Sie dann "Meine Berechtigungen" aus.
  5. Wenn Sie Zugriff auf mehrere Abonnements haben, wählen Sie das entsprechende Abonnement aus.

Bei Azure anmelden

Melden Sie sich mit Ihrem Azure-Konto beim Azure-Portal an.

Visual Studio

In der exemplarischen Vorgehensweise in diesem Artikel wird Visual Studio 2019 verwendet. Die Verfahren für Visual Studio 2013, 2015 oder 2017 können geringfügig abweichen.

Azure .NET SDK

Laden Sie das Azure .NET SDK herunter, und installieren Sie es auf Ihrem Computer.

Erstellen einer Anwendung in Microsoft Entra ID

1. Erstellen Sie unter Erstellen einer Microsoft Entra-Anwendung eine Anwendung, die die .NET-Anwendung darstellt, die Sie in diesem Lernprogramm erstellen. Für die Anmelde-URL können Sie eine Dummy-URL angeben, wie im folgenden Artikel gezeigt ().https://contoso.org/exampleapp
2. Rufen Sie unter Werte für die Anmeldung abrufen die Anwendungs-ID und die Mandanten-ID ab, und notieren Sie sich diese Werte, die Sie später in diesem Lernprogramm verwenden.
3. Rufen Sie unter Zertifikate und Geheimnisse den Authentifizierungsschlüssel ab, und notieren Sie sich diesen Wert, den Sie später in diesem Lernprogramm verwenden.
4. Weisen Sie die Anwendung unter Zuweisen einer Rolle der Rolle " Mitwirkender " auf Abonnementebene zu, damit die Anwendung Data Factorys im Abonnement erstellen kann.

Erstellen eines Visual Studio-Projekts

Erstellen Sie als Nächstes eine C# .NET-Konsolenanwendung in Visual Studio:

1. Starten Sie Visual Studio.
2. Klicken Sie im Startfenster auf Neue Projekt>erstellen Konsolen-App (.NET Framework). .NET Version 4.5.2 oder höher ist erforderlich.
3. Geben Sie unter ProjektnamePurviewQuickStart ein.
4. Wählen Sie "Erstellen " aus, um das Projekt zu erstellen.

Installieren der NuGet-Pakete

1. Extras> auswählenNuGet-Paket-Manager-Paket-Manager-Konsole>.

2. Führen Sie im Bereich Paket-Manager-Konsole die folgenden Befehle aus, um Pakete zu installieren. Weitere Informationen finden Sie unter Microsoft.Azure. Management.Purview NuGet-Paket.

   Install-Package Microsoft.Azure.Management.Purview
   Install-Package Microsoft.Azure.Management.ResourceManager -IncludePrerelease
   Install-Package Microsoft.IdentityModel.Clients.ActiveDirectory
   

Erstellen eines Microsoft Purview-Clients

1. Öffnen Sie Program.cs, schließen Sie die folgenden Anweisungen ein, um Verweise auf Namespaces hinzuzufügen.

   using System;
   using System.Collections.Generic;
   using System.Linq;
   using Microsoft.Rest;
   using Microsoft.Rest.Serialization;
      using Microsoft.Azure.Management.ResourceManager;
   using Microsoft.Azure.Management.Purview;
      using Microsoft.Azure.Management.Purview.Models;
      using Microsoft.IdentityModel.Clients.ActiveDirectory;
   

2. Fügen Sie der Main-Methode, die die Variablen festlegt, den folgenden Code hinzu. Ersetzen Sie die Platzhalter durch Ihre eigenen Werte. Eine Liste der Azure-Regionen, in denen Microsoft Purview derzeit verfügbar ist, finden Sie auf Microsoft Purview, und wählen Sie auf der folgenden Seite die Regionen aus, die Sie interessieren: Verfügbare Produkte nach Region.

   // Set variables
   string tenantID = "<your tenant ID>";
   string applicationId = "<your application ID>";
   string authenticationKey = "<your authentication key for the application>";
   string subscriptionId = "<your subscription ID where the data factory resides>";
   string resourceGroup = "<your resource group where the data factory resides>";
   string region = "<the location of your resource group>";
   string purviewAccountName = 
       "<specify the name of purview account to create. It must be globally unique.>";
   

3. Fügen Sie der Main-Methode, die eine Instance der PurviewManagementClient-Klasse erstellt, den folgenden Code hinzu. Sie verwenden dieses Objekt, um ein Microsoft Purview-Konto zu erstellen.

   // Authenticate and create a purview management client
   var context = new AuthenticationContext("https://login.windows.net/" + tenantID);
   ClientCredential cc = new ClientCredential(applicationId, authenticationKey);
   AuthenticationResult result = context.AcquireTokenAsync(
   "https://management.azure.com/", cc).Result;
   ServiceClientCredentials cred = new TokenCredentials(result.AccessToken);
   var client = new PurviewManagementClient(cred)
   {
      SubscriptionId = subscriptionId           
   };
   

Erstellen eines Kontos

Fügen Sie der Main-Methode, die das Microsoft Purview-Konto erstellt, den folgenden Code hinzu.

// Create a purview Account
Console.WriteLine("Creating Microsoft Purview Account " + purviewAccountName + "...");
Account account = new Account()
{
Location = region,
Identity = new Identity(type: "SystemAssigned"),
Sku = new AccountSku(name: "Standard", capacity: 4)
};            
try
{
  client.Accounts.CreateOrUpdate(resourceGroup, purviewAccountName, account);
  Console.WriteLine(client.Accounts.Get(resourceGroup, purviewAccountName).ProvisioningState);                
}
catch (ErrorResponseModelException purviewException)
{
Console.WriteLine(purviewException.StackTrace);
  }
  Console.WriteLine(
    SafeJsonConvert.SerializeObject(account, client.SerializationSettings));
  while (client.Accounts.Get(resourceGroup, purviewAccountName).ProvisioningState ==
         "PendingCreation")
  {
    System.Threading.Thread.Sleep(1000);
  }
Console.WriteLine("\nPress any key to exit...");
Console.ReadKey();

Führen Sie den Code aus,

Erstellen Sie die Anwendung, starten Sie sie, und überprüfen Sie dann die Ausführung.

Die Konsole druckt den Status der Erstellung des Microsoft Purview-Kontos.

Beispielausgabe

Creating Microsoft Purview Account testpurview...
Succeeded
{
  "sku": {
    "capacity": 4,
    "name": "Standard"
  },
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "southcentralus"
}

Press any key to exit...

Überprüfen der Ausgabe

Wechseln Sie im Azure-Portal zur Seite "Microsoft Purview-Konten", und überprüfen Sie das Konto, das mit dem obigen Code erstellt wurde.

Löschen eines Microsoft Purview-Kontos

Fügen Sie zum programmgesteuerten Löschen eines Microsoft Purview-Kontos die folgenden Codezeilen zum Programm hinzu:

Console.WriteLine("Deleting the Microsoft Purview Account");
client.Accounts.Delete(resourceGroup, purviewAccountName);

Überprüfen, ob der Microsoft Purview-Kontoname verfügbar ist

Verwenden Sie den folgenden Code, um die Verfügbarkeit eines Purview-Kontos zu überprüfen:

CheckNameAvailabilityRequest checkNameAvailabilityRequest = newCheckNameAvailabilityRequest()
{
    Name = purviewAccountName,
    Type =  "Microsoft.Purview/accounts"
};
Console.WriteLine("Check Microsoft Purview account name");
Console.WriteLine(client.Accounts.CheckNameAvailability(checkNameAvailabilityRequest).NameAvailable);

Der obige Code gibt "True" aus, wenn der Name verfügbar ist, und "False", wenn der Name nicht verfügbar ist.

Nächste Schritte

In dieser Schnellstartanleitung haben Sie erfahren, wie Sie ein Microsoft Purview-Konto (früher Azure Purview) erstellen, das Konto löschen und die Verfügbarkeit des Namens überprüfen. Sie können jetzt das .NET SDK herunterladen und sich über andere Ressourcenanbieteraktionen informieren, die Sie für ein Microsoft Purview-Konto ausführen können.

In den nächsten Artikeln erfahren Sie, wie Sie im Microsoft Purview-Governanceportal navigieren, eine Sammlung erstellen und Zugriff auf das Microsoft Purview-Governanceportal gewähren.

• Verwenden des Microsoft Purview-Governanceportals
• Erteilen von Benutzerberechtigungen für das Governanceportal
• Erstellen einer Sammlung