Compartilhar via

New-AzSqlDatabaseExport

Módulo:
Az.Sql Module

Exporta um Banco de Dados SQL do Azure como um arquivo .bacpac para uma conta de armazenamento.

Sintaxe

Default (Default) 

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 Banco de Dados SQL do Azure como um arquivo .bacpac para uma conta de armazenamento. A solicitação obter status do banco de dados de exportação pode ser enviada para recuperar informações de status para essa solicitação. Esse cmdlet também é compatível com o serviço SQL Server Stretch Database em Azure.

Importante

Para usar esse cmdlet, o firewall no Azure SQL Server precisará ser configurado para "Permitir que Azure serviços e recursos acessem esse servidor". Se isso não estiver configurado, os erros do GatewayTimeout serão experimentados. Isso não será necessário se uma conexão Link Privado for estabelecida por meio 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               :

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

Esse comando cria uma solicitação de exportação para o banco de dados especificado usando a identidade gerenciada para autenticação com conectividade em Link Privado.

Parâmetros

-AdministratorLogin

Especifica o nome do administrador do SQL.

Se -AuthenticationType ManagedIdentity for fornecido, essa deverá ser a ID de recurso completa de uma identidade gerenciada atribuída pelo usuário que é um administrador Microsoft Entra do servidor.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AdministratorLoginPassword

Especifica a senha do administrador do SQL.

Propriedades do parâmetro

Tipo:SecureString
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AuthenticationType

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

  • Sql. Autenticação sql. Defina o AdministratorLogin e o AdministratorLoginPassword como o nome de usuário e a senha do administrador do SQL.
  • ADPassword. Microsoft Entra autenticação. Defina AdministratorLogin e AdministratorLoginPassword para o nome de usuário e a senha 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 SQL Server. A identidade gerenciada deve ser uma Microsoft Entra administrador para o servidor.

Propriedades do parâmetro

Tipo:AuthenticationType
Valor padrão:None
Valores aceitos:None, Sql, AdPassword, ManagedIdentity
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DatabaseName

Especifica o nome do Banco de Dados SQL.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-DefaultProfile

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

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ResourceGroupName

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ServerName

Especifica o nome do servidor do Banco de Dados SQL.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-SqlServerResourceIdForPrivateLink

A ID do recurso do sql server para criar um link privado

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-StorageAccountResourceIdForPrivateLink

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

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-StorageKey

Especifica a chave de acesso para a conta de armazenamento.

Quando -StorageKeyType ManagedIdentity for fornecido, essa deve ser a ID de recurso completa de uma identidade gerenciada atribuída pelo usuário que tem acesso de gravação na conta de armazenamento para o StorageUri fornecido (por exemplo, por meio de uma atribuição de função colaborador de dados de blob de armazenamento ).

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 do parâmetro

Tipo:StorageKeyType
Valor padrão:None
Valores aceitos:StorageAccessKey, SharedAccessKey, ManagedIdentity
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-StorageUri

O cmdlet New-AzSqlDatabaseExport exporta um Banco de Dados SQL do Azure como um arquivo .bacpac para uma conta de armazenamento. A solicitação obter status do banco de dados de exportação pode ser enviada para recuperar informações de status para essa solicitação. Esse cmdlet também é compatível com o serviço SQL Server Stretch Database em Azure.

Importante

Para usar esse cmdlet, o firewall no Azure SQL Server precisará ser configurado para "Permitir que Azure serviços e recursos acessem esse servidor". Se isso não estiver configurado, os erros do GatewayTimeout serão experimentados. Isso não será necessário se uma conexão Link Privado for estabelecida por meio do parâmetro UseNetworkIsolation.

Propriedades do parâmetro

Tipo:Uri
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-UseNetworkIsolation

Se definido, criará um link privado para a conta de armazenamento e/ou o SQL Server

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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

Observações

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