Compartilhar via

New-AzSqlDatabaseExport

Módulo:
Az.Sql Module

Exporta uma Azure SQL Database como ficheiro .bacpac para uma conta de armazenamento.

Sintaxe

Default (Predefinição) 

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

O cmdlet New-AzSqlDatabaseExport exporta um Azure SQL Database como ficheiro .bacpac para uma conta de armazenamento. A solicitação de status do banco de dados get export pode ser enviada para recuperar informações de status para essa solicitação. Este cmdlet também é suportado pelo serviço SQL Server Stretch Database no Azure.

Importante

Para utilizar este cmdlet, o firewall no Azure SQL Server terá de ser configurado para "Permitir que Azure serviços e recursos acedam a este servidor". Se isso não estiver configurado, os erros GatewayTimeout serão detetados. Isto não é obrigatório se uma ligação Private Link for estabelecida através do parâmetro UseNetworkIsolation.

Exemplos

Exemplo 1: Criar uma solicitação de exportação para um banco de dados

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               :

Este comando cria uma solicitação de exportação para o banco de dados especificado.

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

Este comando cria um pedido de exportação para a base de dados especificada usando identidade gerida para autenticação com conectividade via Private Link.

Parâmetros

-AdministratorLogin

Especifica o nome do administrador SQL.

Se for fornecido -AuthenticationType ManagedIdentity, este deve ser o ID completo de recurso de uma identidade gerida atribuída pelo utilizador que é um administrador Microsoft Entra do servidor.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-AdministratorLoginPassword

Especifica a senha do administrador SQL.

Propriedades dos parâmetros

Tipo:SecureString
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-AuthenticationType

Especifica o tipo de autenticação usado para acessar o servidor. O valor padrão é SQL se nenhum tipo de autenticação estiver definido. Os valores aceitáveis para este parâmetro são:

  • Sql. Autenticação SQL. Defina AdministratorLogin e AdministratorLoginPassword como o nome de usuário e a senha do administrador SQL.
  • ADPassword. Autenticação Microsoft Entra. Defina AdministratorLogin e AdministratorLoginPassword para o nome de utilizador e palavra-passe do administrador Microsoft Entra. Esse parâmetro só está disponível em servidores do Banco de dados SQL V12.
  • ManagedIdentity. Autenticação de identidade gerenciada. Use uma identidade gerenciada atribuída pelo usuário para autenticar com o servidor SQL. A identidade gerida deve ser um administrador Microsoft Entra para o servidor.

Propriedades dos parâmetros

Tipo:AuthenticationType
Default value:None
Valores aceites:None, Sql, AdPassword, ManagedIdentity
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DatabaseName

Especifica o nome do Banco de Dados SQL.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ResourceGroupName

Especifica o nome do grupo de recursos para o servidor do Banco de dados SQL.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ServerName

Especifica o nome do servidor do Banco de dados SQL.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-SqlServerResourceIdForPrivateLink

A id do recurso do sql server para criar link privado

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-StorageAccountResourceIdForPrivateLink

A ID do recurso da conta de armazenamento para criar um link privado

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-StorageKey

Especifica a chave de acesso para a conta de armazenamento.

Quando é fornecido, esse deve ser o ID de recurso completo de uma identidade gerenciada atribuída pelo usuário que tenha acesso de gravação na conta de armazenamento para o StorageUri fornecido (por exemplo, por meio de uma atribuição de função de Colaborador de Dados de Blob de Armazenamento ).

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-StorageKeyType

Especifica o tipo de chave de acesso para a conta de armazenamento. Os valores aceitáveis para este parâmetro são:

  • StorageAccessKey. Esse valor usa uma chave de conta de armazenamento.
  • SharedAccessKey. Esse valor usa uma chave SAS (Assinatura de Acesso Compartilhado).
  • ManagedIdentity. Use uma identidade gerenciada atribuída pelo usuário para autenticação com a conta de armazenamento.

Propriedades dos parâmetros

Tipo:StorageKeyType
Default value:None
Valores aceites:StorageAccessKey, SharedAccessKey, ManagedIdentity
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-StorageUri

O cmdlet New-AzSqlDatabaseExport exporta um Azure SQL Database como ficheiro .bacpac para uma conta de armazenamento. A solicitação de status do banco de dados get export pode ser enviada para recuperar informações de status para essa solicitação. Este cmdlet também é suportado pelo serviço SQL Server Stretch Database no Azure.

Importante

Para utilizar este cmdlet, o firewall no Azure SQL Server terá de ser configurado para "Permitir que Azure serviços e recursos acedam a este servidor". Se isso não estiver configurado, os erros GatewayTimeout serão detetados. Isto não é obrigatório se uma ligação Private Link for estabelecida através do parâmetro UseNetworkIsolation.

Propriedades dos parâmetros

Tipo:Uri
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-UseNetworkIsolation

Se definido, criará link privado para conta de armazenamento e/ou servidor SQL

Propriedades dos parâmetros

Tipo:Boolean
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

Saídas

AzureSqlDatabaseImportExportBaseModel

Notas

  • Palavras-chave: azure, azurerm, arm, resource, management, manager, sql, database, mssql