Partager via

New-AzSqlDatabaseExport

Module:
Az.Sql Module

Exporte un Azure SQL Database en tant que fichier .bacpac vers un compte de stockage.

Syntaxe

Default (Par défaut) 

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

L’applet de commande New-AzSqlDatabaseExport exporte un Azure SQL Database en tant que fichier .bacpac vers un compte de stockage. La demande obtenir l’état de la base de données d’exportation peut être envoyée pour récupérer les informations d’état de cette demande. Cette applet de commande est également prise en charge par le service SQL Server Stretch Database sur Azure.

Important

Pour utiliser cette applet de commande, le pare-feu sur le Azure SQL Server doit être configuré pour « Autoriser Azure services et ressources à accéder à ce serveur ». S’il n’est pas configuré, les erreurs GatewayTimeout sont rencontrées. Cela n’est pas nécessaire si une connexion Private Link est établie via le paramètre UseNetworkIsolation.

Exemples

Exemple 1 : Créer une demande d’exportation pour une base de données

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               :

Cette commande crée une demande d’exportation pour la base de données spécifiée.

Exemple 2 : Créer une demande d’exportation pour une base de données à l’aide de l’identité managée pour l’authentification via une liaison privée

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

Cette commande crée une demande d’exportation pour la base de données spécifiée à l’aide de l’identité managée pour l’authentification avec une connectivité sur Private Link.

Paramètres

-AdministratorLogin

Spécifie le nom de l’administrateur SQL.

Si -AuthenticationType ManagedIdentity est fourni, il doit s’agir de l’ID de ressource complet d’une identité managée affectée par l’utilisateur qui est un administrateur Microsoft Entra du serveur.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-AdministratorLoginPassword

Spécifie le mot de passe de l’administrateur SQL.

Propriétés du paramètre

Type:SecureString
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-AuthenticationType

Spécifie le type d’authentification utilisé pour accéder au serveur. La valeur par défaut est SQL si aucun type d’authentification n’est défini. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Sql. Authentification SQL. Définissez AdministratorLogin et AdministratorLoginPassword sur le nom d’utilisateur et le mot de passe administrateur SQL.
  • ADPassword. Authentification Microsoft Entra. Définissez AdministratorLogin et AdministratorLoginPassword sur le nom d’utilisateur et le mot de passe de l’administrateur Microsoft Entra. Ce paramètre est disponible uniquement sur les serveurs SQL Database V12.
  • ManagedIdentity. Authentification d’identité managée. Utilisez une identité managée affectée par l’utilisateur pour s’authentifier auprès du serveur SQL. L’identité managée doit être un administrateur Microsoft Entra pour le serveur.

Propriétés du paramètre

Type:AuthenticationType
Valeur par défaut:None
Valeurs acceptées:None, Sql, AdPassword, ManagedIdentity
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DatabaseName

Spécifie le nom de la base de données SQL.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:2
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

Propriétés du paramètre

Type:IAzureContextContainer
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ResourceGroupName

Spécifie le nom du groupe de ressources pour le serveur SQL Database.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ServerName

Spécifie le nom du serveur SQL Database.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-SqlServerResourceIdForPrivateLink

ID de ressource sql server pour créer une liaison privée

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-StorageAccountResourceIdForPrivateLink

ID de ressource du compte de stockage pour créer une liaison privée

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-StorageKey

Spécifie la clé d’accès pour le compte de stockage.

Quand elle est fournie, il doit s’agir de l’ID de ressource complet d’une identité managée affectée par l’utilisateur qui a un accès en écriture sur le compte de stockage pour storageUri fourni (par exemple via une attribution de rôle Contributeur aux données blob de stockage ).

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-StorageKeyType

Spécifie le type de clé d’accès pour le compte de stockage. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • StorageAccessKey. Cette valeur utilise une clé de compte de stockage.
  • SharedAccessKey. Cette valeur utilise une clé SAP (Shared Access Signature).
  • ManagedIdentity. Utilisez une identité managée affectée par l’utilisateur pour l’authentification avec le compte de stockage.

Propriétés du paramètre

Type:StorageKeyType
Valeur par défaut:None
Valeurs acceptées:StorageAccessKey, SharedAccessKey, ManagedIdentity
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-StorageUri

L’applet de commande New-AzSqlDatabaseExport exporte un Azure SQL Database en tant que fichier .bacpac vers un compte de stockage. La demande obtenir l’état de la base de données d’exportation peut être envoyée pour récupérer les informations d’état de cette demande. Cette applet de commande est également prise en charge par le service SQL Server Stretch Database sur Azure.

Important

Pour utiliser cette applet de commande, le pare-feu sur le Azure SQL Server doit être configuré pour « Autoriser Azure services et ressources à accéder à ce serveur ». S’il n’est pas configuré, les erreurs GatewayTimeout sont rencontrées. Cela n’est pas nécessaire si une connexion Private Link est établie via le paramètre UseNetworkIsolation.

Propriétés du paramètre

Type:Uri
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-UseNetworkIsolation

Si cette option est définie, crée une liaison privée pour le compte de stockage et/ou SQL Server

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

String

Sorties

AzureSqlDatabaseImportExportBaseModel

Notes

  • Mots clés : azure, azurerm, arm, resource, management, manager, sql, database, mssql