Schnellstart: Erstellen eines Microsoft Purview-Kontos (früher Azure Purview) mit dem .NET SDK
Hinweis
Microsoft Purview Data Catalog (klassisch) und Data Health Insights (klassisch) übernehmen keine neuen Kunden mehr, und diese Dienste, bisher Azure Purview, befinden sich jetzt im Kundensupportmodus.
Wichtig
Sie können nur ein Microsoft Purview-Konto pro Mandant erstellen. Wenn Ihr organization bereits über ein Microsoft Purview-Konto verfügt, können Sie kein neues Microsoft Purview-Konto erstellen, es sei denn, Ihr organization hatte bereits mehrere Konten und liegt noch unter dem bereits vorhandenen Kontingent. Weitere Informationen finden Sie in den häufig gestellten Fragen.
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 die Microsoft Purview Data Map und Microsoft Purview Data Catalog an, mit denen Sie Ihre Datenlandschaft verwalten und steuern können. Durch das Herstellen einer Verbindung mit Daten in Ihren lokalen, Multicloud- und SaaS-Quellen (Software-as-a-Service) erstellt der Microsoft Purview Data Map eine aktuelle Zuordnung Ihrer Informationen. Es identifiziert und klassifiziert vertrauliche Daten und stellt end-to-End-Linage bereit. Datenconsumer können Daten in Ihren organization ermitteln, und Datenadministratoren können Ihre Daten überwachen, schützen und die richtige Verwendung Ihrer Daten sicherstellen.
Weitere Informationen zu den klassischen Governancefunktionen von Microsoft Purview finden Sie auf unserer Übersichtsseite für Governancelösungen.
Voraussetzungen
Wenn Sie über kein Azure-Abonnement verfügen, erstellen Sie ein kostenloses Abonnement , bevor Sie beginnen.
Ein Microsoft Entra Mandanten, der Ihrem Abonnement zugeordnet ist.
Das Benutzerkonto, das Sie für die Anmeldung bei Azure verwenden, muss Mitglied der Rolle "Mitwirkender" oder "Besitzer" oder ein Administrator des Azure-Abonnements sein. Führen Sie die folgenden Schritte aus, um die Berechtigungen anzuzeigen, über die Sie im Abonnement verfügen:
- Wechseln Sie zum Azure-Portal
- Wählen Sie in der oberen rechten Ecke Ihren Benutzernamen aus.
- Wählen Sie die Schaltfläche mit den Auslassungspunkten ("...") aus, um weitere Optionen anzuzeigen.
- Wählen Sie dann Meine Berechtigungen aus.
- Wenn Sie Zugriff auf mehrere Abonnements haben, wählen Sie das entsprechende Abonnement aus.
Anmelden bei Azure
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
-
Erstellen Sie unter Erstellen einer Microsoft Entra Anwendung eine Anwendung, die die .NET-Anwendung darstellt, die Sie in diesem Tutorial erstellen. Für die Anmelde-URL können Sie eine Dummy-URL angeben, wie im Artikel (
https://contoso.org/exampleapp). - Rufen Sie unter Werte für die Anmeldung die Anwendungs-ID und mandanten-ID ab, und notieren Sie sich diese Werte, die Sie später in diesem Tutorial verwenden.
- Rufen Sie unter Zertifikate und Geheimnisse den Authentifizierungsschlüssel ab, und notieren Sie sich diesen Wert, den Sie später in diesem Tutorial verwenden.
- Weisen Sie unter Zuweisen der Anwendung zu einer Rolle die Anwendung 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:
- Starten Sie Visual Studio.
- Wählen Sie im Fenster Start die Option Neues Projekt>erstellen Konsolen-App (.NET Framework) aus. .NET-Version 4.5.2 oder höher ist erforderlich.
- Geben Sie unter Projektnameden Namen PurviewQuickStart ein.
- Wählen Sie Erstellen aus, um das Projekt zu erstellen.
Installieren der NuGet-Pakete
Wählen Sie Tools>NuGet-Paket-Manager-Paket-Manager-Konsole> aus.
Führen Sie im Bereich Paket-Manager-Konsole die folgenden Befehle aus, um Pakete zu installieren. Weitere Informationen finden Sie im NuGet-Paket Microsoft.Azure.Management.Purview.
Install-Package Microsoft.Azure.Management.Purview Install-Package Microsoft.Azure.Management.ResourceManager -IncludePrerelease Install-Package Microsoft.IdentityModel.Clients.ActiveDirectory
Tipp
Wenn Sie einen Fehler mit folgendem Text erhalten: Paketpaketname <> wurde in den folgenden primären Quellen nicht gefunden, und es wird ein lokaler Ordner aufgelistet, müssen Sie Ihre Paketquellen in Visual Studio aktualisieren, um die NuGet-Website als Onlinequelle einzuschließen.
- Wechseln Sie zu "Tools".
- NuGet-Paket-Manager auswählen
- Wählen Sie Paketverwaltungseinstellungen aus.
- Auswählen von Paketquellen
- Fügen Sie als Quelle hinzu https://nuget.org/api/v2/ .
Erstellen eines Microsoft Purview-Clients
Öffnen Sie Program.cs, fügen 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;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 unter Microsoft Purview , und wählen Sie auf der folgenden Seite die für Sie interessanten Regionen aus: 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.>";Fügen Sie der Main-Methode den folgenden Code hinzu, der eine instance der PurviewManagementClient-Klasse erstellt. 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 den folgenden Code hinzu, mit der das Microsoft Purview-Konto erstellt wird.
// 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();
Ausführen des Codes
Erstellen Und starten Sie die Anwendung, und überprüfen Sie dann die Ausführung.
Die Konsole gibt den Fortschritt der Erstellung des Microsoft Purview-Kontos aus.
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
Um ein Microsoft Purview-Konto programmgesteuert zu löschen, fügen Sie dem Programm die folgenden Codezeilen hinzu:
Console.WriteLine("Deleting the Microsoft Purview Account");
client.Accounts.Delete(resourceGroup, purviewAccountName);
Überprüfen, ob der Name des Microsoft Purview-Kontos 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 mit "True", 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 Namensverfügbarkeit ü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.