New-AzSqlDatabaseImport

Módulo:

Az.Sql Module

Importa un archivo .bacpac y crea una nueva base de datos en el servidor.

Sintaxis

Default (valor predeterminado)

New-AzSqlDatabaseImport
    -DatabaseName <String>
    -Edition <DatabaseEdition>
    -ServiceObjectiveName <String>
    -DatabaseMaxSizeBytes <Int64>
    [-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

El cmdlet New-AzSqlDatabaseImport importa un archivo bacpac desde una cuenta de Azure Storage a una nueva instancia de Azure SQL Database. Se puede enviar la solicitud get import database status para recuperar la información de estado de esta solicitud.

Ejemplos

Ejemplo 1: Crear una solicitud de importación para un archivo bacpac

New-AzSqlDatabaseImport -ResourceGroupName "RG01" -ServerName "Server01" -DatabaseName "Database01" -StorageKeyType "StorageAccessKey" -StorageKey "StorageKey01" -StorageUri "http://account01.blob.core.contoso.net/bacpacs/database01.bacpac" -AdministratorLogin "User" -AdministratorLoginPassword $SecureString -Edition Standard -ServiceObjectiveName S0 -DatabaseMaxSizeBytes 5000000

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.contoso.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 crea una solicitud de importación para importar un archivo .bacpac a una nueva base de datos.

Ejemplo 2

Importa un archivo .bacpac y crea una nueva base de datos en el servidor. (autogenerated)

New-AzSqlDatabaseImport -AdministratorLogin 'User' -AdministratorLoginPassword <SecureString> -AuthenticationType None -DatabaseMaxSizeBytes 5000000 -DatabaseName 'Database01' -Edition None -ResourceGroupName 'RG01' -ServerName 'Server01' -ServiceObjectiveName S0 -StorageKey 'StorageKey01' -StorageKeyType StorageAccessKey -StorageUri 'https://account01.blob.core.contoso.net/bacpacs/database01.bacpac'

Parámetros

-AdministratorLogin

Especifica el nombre del administrador de SQL.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-AdministratorLoginPassword

Especifica la contraseña del administrador de SQL.

Propiedades de parámetro

Tipo:	SecureString
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-AuthenticationType

Especifica el tipo de autenticación que se usa para acceder al servidor. Este parámetro tiene como valor predeterminado SQL si no se establece ningún tipo de autenticación. Los valores aceptables para este parámetro son:

• SQL. Autenticación de SQL. Establezca los parámetros AdministratorLogin y AdministratorLoginPassword en el nombre de usuario y la contraseña del administrador de SQL.
• ADPassword. Autenticación de Microsoft Entra. Establezca AdministratorLogin y AdministratorLoginPassword en el nombre de usuario y la contraseña del administrador de Microsoft Entra. Este parámetro solo está disponible en servidores de SQL Database V12.

Propiedades de parámetro

Tipo:	AuthenticationType
Valor predeterminado:	None
Valores aceptados:	None, Sql, AdPassword, ManagedIdentity
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	False
Admite caracteres comodín:	False
DontShow:	False
Alias:	cf

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-DatabaseMaxSizeBytes

Especifica el tamaño máximo de la base de datos recién importada.

Propiedades de parámetro

Tipo:	Int64
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-DatabaseName

Especifica el nombre de sql Database.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Propiedades de parámetro

Tipo:	IAzureContextContainer
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-Edition

Especifica la edición de la nueva base de datos a la que se va a importar. Los valores aceptables para este parámetro son:

• Premium
• Básico
• Estándar
• Almacén de datos
• Gratuito

Propiedades de parámetro

Tipo:	DatabaseEdition
Valor predeterminado:	None
Valores aceptados:	None, Premium, Basic, Standard, DataWarehouse, Stretch, Free, PremiumRS, GeneralPurpose, BusinessCritical, Hyperscale
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-ResourceGroupName

Especifica el nombre del grupo de recursos para el servidor de SQL Database.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	0
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-ServerName

Especifica el nombre del servidor de SQL Database.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	1
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	True
Valor de los argumentos restantes:	False

-ServiceObjectiveName

Especifica el nombre del objetivo de servicio que se va a asignar a Azure SQL Database.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-SqlServerResourceIdForPrivateLink

Identificador de recurso de sql Server para crear un vínculo privado

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-StorageAccountResourceIdForPrivateLink

Identificador de recurso de la cuenta de almacenamiento para crear un vínculo privado

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-StorageKey

Especifica la clave de acceso de la cuenta de almacenamiento.

Propiedades de parámetro

Tipo:	String
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-StorageKeyType

Especifica el tipo de clave de acceso para la cuenta de almacenamiento. Los valores aceptables para este parámetro son:

• StorageAccessKey. Usa la clave de la cuenta de almacenamiento.
• SharedAccessKey. Usa la clave firma de acceso compartido (SAS).

Propiedades de parámetro

Tipo:	StorageKeyType
Valor predeterminado:	None
Valores aceptados:	StorageAccessKey, SharedAccessKey, ManagedIdentity
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-StorageUri

Especifica el URI del blob del archivo .bacpac.

Propiedades de parámetro

Tipo:	Uri
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	True
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-UseNetworkIsolation

Si se establece, creará un vínculo privado para la cuenta de almacenamiento o SQL Server.

Propiedades de parámetro

Tipo:	Boolean
Valor predeterminado:	None
Admite caracteres comodín:	False
DontShow:	False

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades de parámetro

Tipo:	SwitchParameter
Valor predeterminado:	False
Admite caracteres comodín:	False
DontShow:	False
Alias:	Wi

Conjuntos de parámetros

(All)

Posición:	Named
Obligatorio:	False
Valor de la canalización:	False
Valor de la canalización por nombre de propiedad:	False
Valor de los argumentos restantes:	False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

String

Salidas

AzureSqlDatabaseImportExportBaseModel

Notas

• Palabras clave: azure, azurerm, arm, resource, management, manager, sql, database, mssql

Vínculos relacionados

• Get-AzSqlDatabaseImportExportStatus
• New-AzSqlDatabaseExport
• Documentación de SQL Database