New-AzSqlDatabaseExport

Modul:

Az.Sql Module

Exporterar en Azure SQL Database som en .bacpac-fil till ett lagringskonto.

Syntax

Default (Standard)

New-AzSqlDatabaseExport
    [-DatabaseName] <String>
    [-ServerName] <String>
    -StorageKeyType <StorageKeyType>
    -StorageKey <String>
    -StorageUri <Uri>
    -AdministratorLogin <String>
    -AdministratorLoginPassword <SecureString>
    [-AuthenticationType <AuthenticationType>]
    [-UseNetworkIsolation <Boolean>]
    [-StorageAccountResourceIdForPrivateLink <String>]
    [-SqlServerResourceIdForPrivateLink <String>]
    [-ResourceGroupName] <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Cmdleten New-AzSqlDatabaseExport exporterar en Azure SQL Database som en .bacpac-fil till ett lagringskonto. Begäran om status för hämta exportdatabasen kan skickas för att hämta statusinformation för den här begäran. Den här cmdleten stöds också av SQL Server Stretch Database-tjänsten i Azure.

Viktigt!

För att kunna använda den här cmdleten måste brandväggen på Azure SQL Server konfigureras för att "Tillåta Azure-tjänster och resurser att komma åt den här servern". Om detta inte har konfigurerats uppstår GatewayTimeout-fel. Detta krävs inte om en Private Link-anslutning upprättas via parametern UseNetworkIsolation.

Exempel

Exempel 1: Skapa en exportbegäran för en databas

New-AzSqlDatabaseExport -ResourceGroupName "RG01" -ServerName "Server01" -DatabaseName "Database01" -StorageKeyType "StorageAccessKey" -StorageKey "StorageKey01" -StorageUri "http://account01.blob.core.contoso.net/bacpacs/database01.bacpac" -AdministratorLogin "User" -AdministratorLoginPassword "secure password"

ResourceGroupName          : RG01
ServerName                 : Server01
DatabaseName               : Database01
StorageKeyType             : StorageAccessKey
StorageKey                 :
StorageUri                 : http://account01.blob.core.contoso.net/bacpacs/database01.bacpac
AdministratorLogin         : User
AdministratorLoginPassword :
AuthenticationType         : None
OperationStatusLink        : https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resource01/providers/Microsoft.Sql/servers/server01/databases/database01/importExportOperationResults/00000000-00
                             0-0000-0000-000000000000?api-version=2014-04-01
Status                     : InProgress
ErrorMessage               :

Det här kommandot skapar en exportbegäran för den angivna databasen.

Exempel 2: Skapa en exportbegäran för en databas med hanterad identitet för autentisering via privat länk

$sqlServerName = "Server01"
$storageAccountName = "storageaccount1"
$subscriptionId = "00000000-0000-0000-0000-000000000000"
$resourceGroup = "RG01"
$managedIdentityResourceId = "/subscriptions/$subscriptionId/resourceGroups/$resourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/my-managed-identity"
$pw = ConvertTo-SecureString "******" -AsPlainText -Force
New-AzSqlDatabaseExport `
    -ResourceGroupName $resourceGroup `
    -ServerName $sqlServerName `
    -DatabaseName "Database01" `
    -StorageKeyType ManagedIdentity `
    -StorageKey $managedIdentityResourceId `
    -StorageUri "https://storageaccount1.blob.core.windows.net/container1/my-file-name.bacpac" `
    -AuthenticationType ManagedIdentity `
    -AdministratorLogin $managedIdentityResourceId `
    -AdministratorLoginPassword $pw `
    -UseNetworkIsolation $true `
    -SqlServerResourceIdForPrivateLink "/subscriptions/$subscriptionId/resourceGroups/$resourceGroup/providers/Microsoft.Sql/servers/$sqlServerName" `
    -StorageAccountResourceIdForPrivateLink "/subscriptions/$subscriptionId/resourceGroups/$resourceGroup/providers/Microsoft.Storage/storageAccounts/$storageAccountName"

Det här kommandot skapar en exportbegäran för den angivna databasen med hjälp av hanterad identitet för autentisering med anslutning via Private Link.

Parametrar

-AdministratorLogin

Anger namnet på SQL-administratören.

Om -AuthenticationType ManagedIdentity anges bör detta vara det fullständiga resurs-ID:t för en användartilldelad hanterad identitet som är microsoft entra-administratör för servern.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-AdministratorLoginPassword

Anger lösenordet för SQL-administratören.

Parameteregenskaper

Typ:	SecureString
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-AuthenticationType

Anger vilken typ av autentisering som används för att komma åt servern. Standardvärdet är SQL om ingen autentiseringstyp har angetts. De godtagbara värdena för den här parametern är:

• SQL. SQL-autentisering. Ange användarnamnet och lösenordet för SQL-administratören för AdministratorLogin och AdministratorLoginPassword .
• ADPassword. Microsoft Entra-autentisering. Ange AdministratorLogin och AdministratorLoginPassword till användarnamnet och lösenordet för Microsoft Entra-administratören. Den här parametern är endast tillgänglig på SQL Database V12-servrar.
• ManagedIdentity. Hanterad identitetsautentisering. Använd en användartilldelad hanterad identitet för att autentisera med SQL-servern. Den hanterade identiteten måste vara Microsoft Entra-administratör för servern.

Parameteregenskaper

Typ:	AuthenticationType
Standardvärde:	None
Godkända värden:	None, Sql, AdPassword, ManagedIdentity
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Parameteregenskaper

Typ:	SwitchParameter
Standardvärde:	False
Stöder jokertecken:	False
DontShow:	False
Alias:	jfr

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-DatabaseName

Anger namnet på SQL Database.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	2
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure

Parameteregenskaper

Typ:	IAzureContextContainer
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-ResourceGroupName

Anger namnet på resursgruppen för SQL Database-servern.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	0
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-ServerName

Anger namnet på SQL Database-servern.

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	1
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	True
Värde från återstående argument:	False

-SqlServerResourceIdForPrivateLink

Sql Server-resurs-ID:t för att skapa en privat länk

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-StorageAccountResourceIdForPrivateLink

Lagringskontots resurs-ID för att skapa en privat länk

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-StorageKey

Anger åtkomstnyckeln för lagringskontot.

När -StorageKeyType ManagedIdentity tillhandahålls bör detta vara det fullständiga resurs-ID:t för en användartilldelad hanterad identitet som har skrivåtkomst till lagringskontot för den StorageUri som tillhandahålls (till exempel via en rolltilldelning för Storage Blob Data Contributor ).

Parameteregenskaper

Typ:	String
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-StorageKeyType

Anger typ av åtkomstnyckel för lagringskontot. De godtagbara värdena för den här parametern är:

• StorageAccessKey. Det här värdet använder en lagringskontonyckel.
• SharedAccessKey. Det här värdet använder en SAS-nyckel (Signatur för delad åtkomst).
• ManagedIdentity. Använd en användartilldelad hanterad identitet för autentisering med lagringskontot.

Parameteregenskaper

Typ:	StorageKeyType
Standardvärde:	None
Godkända värden:	StorageAccessKey, SharedAccessKey, ManagedIdentity
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-StorageUri

Cmdleten New-AzSqlDatabaseExport exporterar en Azure SQL Database som en .bacpac-fil till ett lagringskonto. Begäran om status för hämta exportdatabasen kan skickas för att hämta statusinformation för den här begäran. Den här cmdleten stöds också av SQL Server Stretch Database-tjänsten i Azure.

Viktigt!

För att kunna använda den här cmdleten måste brandväggen på Azure SQL Server konfigureras för att "Tillåta Azure-tjänster och resurser att komma åt den här servern". Om detta inte har konfigurerats uppstår GatewayTimeout-fel. Detta krävs inte om en Private Link-anslutning upprättas via parametern UseNetworkIsolation.

Parameteregenskaper

Typ:	Uri
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	True
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-UseNetworkIsolation

Om det anges skapar du en privat länk för lagringskontot och/eller SQL-servern

Parameteregenskaper

Typ:	Boolean
Standardvärde:	None
Stöder jokertecken:	False
DontShow:	False

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

-WhatIf

Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.

Parameteregenskaper

Typ:	SwitchParameter
Standardvärde:	False
Stöder jokertecken:	False
DontShow:	False
Alias:	Wi

Parameteruppsättningar

(All)

Position:	Named
Obligatorisk:	False
Värde från pipeline:	False
Värde från pipeline efter egenskapsnamn:	False
Värde från återstående argument:	False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

String

Utdata

AzureSqlDatabaseImportExportBaseModel

Kommentarer

• Nyckelord: azure, azurerm, arm, resource, management, manager, sql, database, mssql

Relaterade länkar

• Get-AzSqlDatabaseImportExportStatus
• New-AzSqlDatabaseImport
• Dokumentation om SQL Database