Condividi tramite

New-AzSqlDatabaseExport

Modulo:
Az.Sql Module

Esporta un Azure SQL Database come file bacpac in un account di archiviazione.

Sintassi

Default (Impostazione predefinita) 

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>]

Descrizione

Il cmdlet New-AzSqlDatabaseExport esporta un Azure SQL Database come file bacpac in un account di archiviazione. È possibile inviare la richiesta di stato del database get export per recuperare le informazioni sullo stato per questa richiesta. Questo cmdlet è supportato anche dal servizio SQL Server Stretch Database in Azure.

Importante

Per usare questo cmdlet, il firewall nel Azure SQL Server dovrà essere configurato in "Consenti ai servizi e alle risorse di Azure di accedere a questo server". Se questa impostazione non è configurata, verranno riscontrati errori gatewayTimeout. Questa operazione non è necessaria se viene stabilita una connessione Private Link tramite il parametro UseNetworkIsolation.

Esempio

Esempio 1: Creare una richiesta di esportazione per un database

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               :

Questo comando crea una richiesta di esportazione per il database specificato.

Esempio 2: Creare una richiesta di esportazione per un database usando l'identità gestita per l'autenticazione tramite collegamento privato

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

Questo comando crea una richiesta di esportazione per il database specificato usando l'identità gestita per l'autenticazione con connettività tramite Private Link.

Parametri

-AdministratorLogin

Specifica il nome dell'amministratore SQL.

Se viene specificato -AuthenticationType ManagedIdentity, deve trattarsi dell'ID risorsa completo di un'identità gestita assegnata dall'utente Microsoft Entra administrator del server.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-AdministratorLoginPassword

Specifica la password dell'amministratore SQL.

Proprietà dei parametri

Tipo:SecureString
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-AuthenticationType

Specifica il tipo di autenticazione utilizzato per accedere al server. Il valore predefinito è SQL se non è impostato alcun tipo di autenticazione. I valori accettabili per questo parametro sono:

  • Sql. Autenticazione SQL. Impostare AdministratorLogin e AdministratorLoginPassword sul nome utente e la password dell'amministratore SQL.
  • ADPassword. Microsoft Entra l'autenticazione. Impostare AdministratorLogin e AdministratorLoginPassword al nome utente e alla password dell'amministratore Microsoft Entra. Questo parametro è disponibile solo nei server del database SQL V12.
  • ManagedIdentity. Autenticazione dell'identità gestita. Usare un'identità gestita assegnata dall'utente per l'autenticazione con SQL Server. L'identità gestita deve essere un amministratore Microsoft Entra per il server.

Proprietà dei parametri

Tipo:AuthenticationType
Valore predefinito:None
Valori accettati:None, Sql, AdPassword, ManagedIdentity
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:Cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DatabaseName

Specifica il nome del database SQL.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:2
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ResourceGroupName

Specifica il nome del gruppo di risorse per il server di database SQL.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-ServerName

Specifica il nome del server di database SQL.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-SqlServerResourceIdForPrivateLink

ID risorsa sql server per creare un collegamento privato

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-StorageAccountResourceIdForPrivateLink

ID risorsa dell'account di archiviazione per creare un collegamento privato

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-StorageKey

Specifica la chiave di accesso per l'account di archiviazione.

Quando viene specificato, deve trattarsi dell'ID risorsa completo di un'identità gestita assegnata dall'utente che ha accesso in scrittura all'account di archiviazione per l'URI di archiviazione fornito, ad esempio tramite un'assegnazione di ruolo Collaboratore ai dati del BLOB di archiviazione .

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-StorageKeyType

Specifica il tipo di chiave di accesso per l'account di archiviazione. I valori accettabili per questo parametro sono:

  • StorageAccessKey. Questo valore usa una chiave dell'account di archiviazione.
  • SharedAccessKey. Questo valore usa una chiave di firma di accesso condiviso .This value uses a Shared Access Signature (SAS) key.
  • ManagedIdentity. Usare un'identità gestita assegnata dall'utente per l'autenticazione con l'account di archiviazione.

Proprietà dei parametri

Tipo:StorageKeyType
Valore predefinito:None
Valori accettati:StorageAccessKey, SharedAccessKey, ManagedIdentity
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-StorageUri

Il cmdlet New-AzSqlDatabaseExport esporta un Azure SQL Database come file bacpac in un account di archiviazione. È possibile inviare la richiesta di stato del database get export per recuperare le informazioni sullo stato per questa richiesta. Questo cmdlet è supportato anche dal servizio SQL Server Stretch Database in Azure.

Importante

Per usare questo cmdlet, il firewall nel Azure SQL Server dovrà essere configurato in "Consenti ai servizi e alle risorse di Azure di accedere a questo server". Se questa impostazione non è configurata, verranno riscontrati errori gatewayTimeout. Questa operazione non è necessaria se viene stabilita una connessione Private Link tramite il parametro UseNetworkIsolation.

Proprietà dei parametri

Tipo:Uri
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-UseNetworkIsolation

Se impostato, creerà un collegamento privato per l'account di archiviazione e/o SQL Server

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

String

Output

AzureSqlDatabaseImportExportBaseModel

Note

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