New-AzSqlDatabaseExport

Modul:

Az.Sql Module

Exportuje službu 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 službu 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 v Azure.

Důležité

Aby bylo možné tuto rutinu použít, musí být brána firewall na Azure SQL Serveru nakonfigurovaná tak, aby umožňovala službám a prostředkům Azure 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 -AuthenticationType ManagedIdentity je k dispozici, mělo by se jednat o úplné ID prostředku spravované identity přiřazené uživatelem, která je správcem serveru Microsoft Entra .

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. Ověřování Microsoft Entra. 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 službu 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 v Azure.

Důležité

Aby bylo možné tuto rutinu použít, musí být brána firewall na Azure SQL Serveru nakonfigurovaná tak, aby umožňovala službám a prostředkům Azure 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