Referenz zur Verwaltungs-API für verwaltete Azure SQL-Datenbank-InstanzenManaged API reference for Azure SQL Database Managed Instances

Sie können verwaltete Azure SQL-Datenbank-Instanzen mit dem Azure-Portal, mit PowerShell, der Azure CLI, der REST-API oder Transact-SQL erstellen und verwalten.You can create and manage Azure SQL Database Managed Instances using the Azure portal, PowerShell, Azure CLI, REST API, and Transact-SQL. Dieser Artikel gibt Ihnen eine Übersicht über Funktionen und API, die Sie zum Erstellen und Konfigurieren einer verwalteten Instanz verwenden können.In this article, you can find an overview of functions and API that you can use to create and configure Managed Instance.

Azure-Portal: Erstellen einer verwalteten InstanzAzure portal: Create a managed instance

Eine Schnellstartanleitung zum Erstellen einer verwalteten Azure SQL-Datenbank-Instanz finden Sie unter Schnellstart: Erstellen einer verwalteten Azure SQL-Datenbank-Instanz.For a quickstart showing you how to create an Azure SQL Database Managed Instance, see Quickstart: Create an Azure SQL Database Managed Instance.

PowerShell: Erstellen und Verwalten verwalteter InstanzenPowerShell: Create and manage managed instances

Hinweis

Dieser Artikel wurde aktualisiert und beinhaltet jetzt das neue Az-Modul von Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Sie können das AzureRM-Modul weiterhin verwenden, das bis mindestens Dezember 2020 weiterhin Fehlerbehebungen erhält.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Weitere Informationen zum neuen Az-Modul und zur Kompatibilität mit AzureRM finden Sie unter Introducing the new Azure PowerShell Az module (Einführung in das neue Az-Modul von Azure PowerShell).To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Anweisungen zur Installation des Az-Moduls finden Sie unter Install Azure PowerShell (Installieren von Azure PowerShell).For Az module installation instructions, see Install Azure PowerShell.

Wichtig

Das PowerShell Azure Resource Manager-Modul wird von der Azure SQL-Datenbank weiterhin unterstützt, aber alle zukünftigen Entwicklungen erfolgen für das Az.Sql-Modul.The PowerShell Azure Resource Manager module is still supported by Azure SQL Database, but all future development is for the Az.Sql module. Informationen zu diesen Cmdlets finden Sie unter AzureRM.Sql.For these cmdlets, see AzureRM.Sql. Die Argumente für die Befehle im Az- und den AzureRm-Modulen sind im Wesentlichen identisch.The arguments for the commands in the Az module and in the AzureRm modules are substantially identical.

Verwenden Sie zum Erstellen und Verwalten verwalteter Instanzen mithilfe von Azure PowerShell die folgenden PowerShell-Cmdlets.To create and manage managed instances with Azure PowerShell, use the following PowerShell cmdlets. Wenn Sie PowerShell installieren oder aktualisieren müssen, helfen Ihnen die Informationen unter Installieren des Azure PowerShell-Moduls weiter.If you need to install or upgrade PowerShell, see Install Azure PowerShell module.

CmdletCmdlet BESCHREIBUNGDescription
New-AzSqlInstanceNew-AzSqlInstance Erstellt eine verwaltete Azure SQL-Datenbank-InstanzCreates an Azure SQL Database Managed Instance
Get-AzSqlInstanceGet-AzSqlInstance Gibt Informationen zur verwalteten Azure SQL-Instanz zurückReturns information about Azure SQL Managed Instance
Set-AzSqlInstanceSet-AzSqlInstance Legt Eigenschaften für eine verwaltete Azure SQL-Datenbank-Instanz festSets properties for an Azure SQL Database Managed Instance
Remove-AzSqlInstanceRemove-AzSqlInstance Entfernt eine verwaltete Azure SQL-Datenbank-InstanzRemoves an Azure SQL Managed Database Instance
New-AzSqlInstanceDatabaseNew-AzSqlInstanceDatabase Erstellt eine Datenbank der verwalteten Azure SQL-Datenbank-InstanzCreates an Azure SQL Database Managed Instance database
Get-AzSqlInstanceDatabaseGet-AzSqlInstanceDatabase Gibt Informationen zur Datenbank der verwalteten Azure SQL-Instanz zurückReturns information about Azure SQL Managed Instance database
Remove-AzSqlInstanceDatabaseRemove-AzSqlInstanceDatabase Entfernt eine Datenbank der verwalteten Azure SQL-Datenbank-InstanzRemoves an Azure SQL Managed Database Instance database
Restore-AzSqlInstanceDatabaseRestore-AzSqlInstanceDatabase Stellt eine Datenbank der verwalteten Azure SQL-Datenbank-Instanz wieder herRestores an Azure SQL Managed Database Instance database

Azure-Befehlszeilenschnittstelle: Erstellen und Verwalten verwalteter InstanzenAzure CLI: Create and manage managed instances

Verwenden Sie zum Erstellen und Verwalten verwalteter Instanzen mithilfe der Azure CLI die folgenden Azure CLI-Befehle für eine verwaltete SQL-Instanz.To create and manage managed instances with Azure CLI, use the following Azure CLI SQL Managed Instance commands. Führen Sie die CLI mithilfe von Cloud Shell in Ihrem Browser aus, oder installieren Sie sie unter macOS, Linux oder Windows.Use the Cloud Shell to run the CLI in your browser, or install it on macOS, Linux, or Windows.

Tipp

Eine Azure CLI-Schnellstartanleitung finden Sie unter Arbeiten mit einer verwalteten SQL-Instanz mithilfe der Azure CLI.For an Azure CLI quickstart, see Working with SQL Managed Instance using Azure CLI.

CmdletCmdlet BESCHREIBUNGDescription
az sql mi createaz sql mi create Erstellt eine verwaltete InstanzCreates a Managed Instance
az sql mi listaz sql mi list Listet verfügbare verwaltete Instanzen aufLists available Managed Instances
az sql mi showaz sql mi show Ruft die Details für eine verwaltete Instanz abGet the details for a Managed Instance
az sql mi updateaz sql mi update Aktualisiert eine verwaltete InstanzUpdates a Managed Instance
az sql mi deleteaz sql mi delete Entfernt eine verwaltete InstanzRemoves a Managed Instance
az sql midb createaz sql midb create Erstellt eine verwaltete DatenbankCreates a managed database
az sql midb listaz sql midb list Listet verfügbare verwaltete Datenbanken aufLists available managed databases
az sql midb restoreaz sql midb restore Stellt eine verwaltete Datenbank wieder herRestore a managed database
az sql midb deleteaz sql midb delete Entfernt eine verwaltete DatenbankRemoves a managed database

Transact-SQL: Erstellen und Verwalten von InstanzdatenbankenTransact-SQL: Create and manage instance databases

Verwenden Sie zum Erstellen und Verwalten einer Instanzdatenbank nach dem Erstellen der verwalteten Instanz die folgenden T-SQL-Befehle.To create and manage instance database after the Managed Instance is created, use the following T-SQL commands. Sie können diese Befehle über das Azure-Portal, SQL Server Management Studio, Azure Data Studio,You can issue these commands using the Azure portal, SQL Server Management Studio, Azure Data Studio. Visual Studio Code oder ein anderes Programm ausgeben, mit dem eine Verbindung mit einem Azure SQL-Datenbank-Server hergestellt und Transact-SQL-Befehle übergeben werden können.Visual Studio Code, or any other program that can connect to an Azure SQL Database server and pass Transact-SQL commands.

Tipp

Schnellstartanleitungen, in denen gezeigt wird, wie Sie eine verwaltete Instanz mithilfe von SQL Server Management Studio unter Microsoft Windows konfigurieren und eine Verbindung herstellen, finden Sie unter Schnellstart: Konfigurieren einer Azure-VM für das Herstellen einer Verbindung mit einer verwalteten Azure SQL-Datenbank-Instanz und Schnellstart: Konfigurieren einer Point-to-Site-Verbindung von einem lokalen Computer mit einer verwalteten Azure SQL-Datenbank-Instanz.For quickstarts showing you have to configure and connect to a Managed Instance using SQL Server Management Studio on Microsoft Windows, see Quickstart: Configure Azure VM to connect to an Azure SQL Database Managed Instance and Quickstart: Configure a point-to-site connection to an Azure SQL Database Managed Instance from on-premises.

Wichtig

Sie können eine verwaltete Instanz mithilfe von Transact-SQL nicht erstellen oder löschen.You cannot create or delete a Managed Instance using Transact-SQL.

Get-HelpCommand BESCHREIBUNGDescription
CREATE DATABASECREATE DATABASE Erstellt eine neue Datenbank der verwalteten Instanz.Creates a new Managed Instance database. Sie müssen über eine Verbindung mit der Masterdatenbank verfügen, um eine neue Datenbank erstellen zu können.You must be connected to the master database to create a new database.
ALTER DATABASEALTER DATABASE Ändert eine Datenbank der verwalteten Azure SQL-Instanz.Modifies an Azure SQL Managed Instance database.

REST-API: Erstellen und Verwalten verwalteter InstanzenREST API: Create and manage managed instances

Verwenden Sie zum Erstellen und Verwalten verwalteter Instanzen die folgenden REST-API-Anforderungen.To create and manage Managed Instances, use these REST API requests.

Get-HelpCommand BESCHREIBUNGDescription
Verwaltete Instanzen – Erstellen oder AktualisierenManaged Instances - Create Or Update Erstellt oder aktualisiert eine verwaltete Instanz.Creates or updates a Managed Instance.
Verwaltete Instanzen – LöschenManaged Instances - Delete Löscht eine verwaltete Instanz.Deletes a Managed Instance.
Verwaltete Instanzen – AbrufenManaged Instances - Get Ruft eine verwaltete Instanz ab.Gets a Managed Instance.
Verwaltete Instanzen – AuflistenManaged Instances - List Gibt eine Liste der verwalteten Instanzen in einem Abonnement zurück.Returns a list of Managed Instances in a subscription.
Verwaltet Instanzen – Auflisten nach RessourcengruppeManaged Instances - List By Resource Group Gibt eine Liste der verwalteten Instanzen in einer Ressourcengruppe zurück.Returns a list of Managed Instances in a resource group.
Verwaltete Instanzen – AktualisierenManaged Instances - Update Aktualisiert eine verwaltete Instanz.Updates a Managed Instance.

Nächste SchritteNext steps