Dela via

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 tjänsten SQL Server Stretch Database på Azure.

Viktigt!

För att kunna använda den här cmdleten måste brandväggen på Azure SQL Server konfigureras till "Tillåt 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 hanterad identitet för autentisering med anslutning via Private Link.

Parametrar

-AdministratorLogin

Anger namnet på SQL-administratören.

Om -AuthenticationType ManagedIdentity tillhandahålls bör detta vara det fullständiga resurs-ID:t för en användartilldelad hanterad identitet som är en Microsoft Entra administratör på 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ör. 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 en 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

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
(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

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
(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 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 tjänsten SQL Server Stretch Database på Azure.

Viktigt!

För att kunna använda den här cmdleten måste brandväggen på Azure SQL Server konfigureras till "Tillåt 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