New-AzSqlDatabaseExport

Modul:

Az.Sql Module

Exportuje Azure SQL Database jako soubor .bacpac do účtu úložiště.

Syntax

Default (Výchozí)

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

Rutina New-AzSqlDatabaseExport exportuje Azure SQL Database jako soubor .bacpac do účtu úložiště. Žádost o získání stavu databáze pro export může být odeslána za účelem načtení informací o stavu pro tuto žádost. Tuto rutinu podporuje také služba SQL Server Stretch Database na Azure.

Important

Aby bylo možné tuto rutinu použít, musí být brána firewall na Azure SQL Server nakonfigurovaná na možnost Povolit Azure službám a prostředkům přístup k tomuto serveru. Pokud tato konfigurace není nakonfigurovaná, dojde k chybám GatewayTimeout. To se nevyžaduje, pokud je připojení Private Link vytvořeno prostřednictvím parametru UseNetworkIsolation.

Příklady

Příklad 1: Vytvoření žádosti o export pro databázi

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               :

Tento příkaz vytvoří požadavek na export pro zadanou databázi.

Příklad 2: Vytvoření žádosti o export pro databázi pomocí spravované identity pro ověřování přes privátní propojení

$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"

Tento příkaz vytvoří žádost o export pro zadanou databázi pomocí spravované identity pro ověřování s připojením přes Private Link.

Parametry

-AdministratorLogin

Určuje název správce SQL.

Pokud je k dispozici -AuthenticationType ManagedIdentity, mělo by se jednat o úplné ID prostředku spravované identity přiřazené uživatelem, která je správcem Microsoft Entra serveru.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-AdministratorLoginPassword

Určuje heslo správce SQL.

Vlastnosti parametru

Typ:	SecureString
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-AuthenticationType

Určuje typ ověřování, který se používá pro přístup k serveru. Výchozí hodnota je SQL, pokud není nastaven žádný typ ověřování. Přijatelné hodnoty pro tento parametr jsou:

• Sql. Ověřování SQL Nastavte AdministratorLogin a AdministratorLoginPassword na uživatelské jméno a heslo správce SQL.
• ADPassword. Microsoft Entra ověřování. Nastavte AdministratorLogin a AdministratorLoginPassword na uživatelské jméno a heslo správce Microsoft Entra. Tento parametr je k dispozici pouze na serverech SQL Database V12.
• ManagedIdentity. Ověřování spravované identity Použijte spravovanou identitu přiřazenou uživatelem k ověření pomocí SQL Serveru. Spravovaná identita musí být správcem Microsoft Entra pro server.

Vlastnosti parametru

Typ:	AuthenticationType
Default value:	None
Přípustné hodnoty:	None, Sql, AdPassword, ManagedIdentity
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	viz

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DatabaseName

Určuje název databáze SQL.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	2
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

Vlastnosti parametru

Typ:	IAzureContextContainer
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ResourceGroupName

Určuje název skupiny prostředků pro server služby SQL Database.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	0
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ServerName

Určuje název serveru služby SQL Database.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	1
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-SqlServerResourceIdForPrivateLink

ID prostředku SQL Serveru pro vytvoření privátního propojení

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-StorageAccountResourceIdForPrivateLink

ID prostředku účtu úložiště pro vytvoření privátního propojení

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-StorageKey

Určuje přístupový klíč pro účet úložiště.

Pokud -StorageKeyType ManagedIdentity je k dispozici, mělo by se jednat o úplné ID prostředku spravované identity přiřazené uživatelem, která má přístup k zápisu do účtu úložiště pro zadaný identifikátor StorageURI (například prostřednictvím přiřazení role Přispěvatel dat v objektech blob služby Storage ).

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-StorageKeyType

Určuje typ přístupového klíče pro účet úložiště. Přijatelné hodnoty pro tento parametr jsou:

• StorageAccessKey. Tato hodnota používá klíč účtu úložiště.
• SharedAccessKey. Tato hodnota používá klíč sdíleného přístupového podpisu (SAS).
• ManagedIdentity. Pro ověřování s účtem úložiště použijte spravovanou identitu přiřazenou uživatelem.

Vlastnosti parametru

Typ:	StorageKeyType
Default value:	None
Přípustné hodnoty:	StorageAccessKey, SharedAccessKey, ManagedIdentity
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-StorageUri

Rutina New-AzSqlDatabaseExport exportuje Azure SQL Database jako soubor .bacpac do účtu úložiště. Žádost o získání stavu databáze pro export může být odeslána za účelem načtení informací o stavu pro tuto žádost. Tuto rutinu podporuje také služba SQL Server Stretch Database na Azure.

Important

Aby bylo možné tuto rutinu použít, musí být brána firewall na Azure SQL Server nakonfigurovaná na možnost Povolit Azure službám a prostředkům přístup k tomuto serveru. Pokud tato konfigurace není nakonfigurovaná, dojde k chybám GatewayTimeout. To se nevyžaduje, pokud je připojení Private Link vytvořeno prostřednictvím parametru UseNetworkIsolation.

Vlastnosti parametru

Typ:	Uri
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-UseNetworkIsolation

Pokud je nastavení nastavené, vytvoří se privátní propojení pro účet úložiště nebo SQL Server.

Vlastnosti parametru

Typ:	Boolean
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Wi

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

Výstupy

AzureSqlDatabaseImportExportBaseModel

Poznámky

• Klíčová slova: azure, azurerm, arm, resource, management, manager, sql, database, mssql

Související odkazy

• Get-AzSqlDatabaseImportExportStatus
• New-AzSqlDatabaseImport
• Dokumentace ke službě SQL Database