New-AzSqlDatabaseExport

Модуль:

Az.Sql Module

Экспорт базы данных SQL Azure в виде BACPAC-файла в учетную запись хранения.

Синтаксис

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

Описание

Командлет New-AzSqlDatabaseExport экспортирует базу данных SQL Azure в виде BACPAC-файла в учетную запись хранения. Запрос состояния базы данных экспорта может быть отправлен для получения сведений о состоянии этого запроса. Этот командлет также поддерживается в службе SQL Server Stretch Database в Azure.

Это важно

Чтобы использовать этот командлет брандмауэра на сервере SQL Server Azure, необходимо настроить параметр "Разрешить службам и ресурсам Azure доступ к этому серверу". Если это не настроено, будут возникать ошибки GatewayTimeout. Это не обязательно, если подключение приватного канала установлено с помощью параметра UseNetworkIsolation.

Примеры

Пример 1. Создание запроса на экспорт для базы данных

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               :

Эта команда создает запрос на экспорт для указанной базы данных.

Пример 2. Создание запроса на экспорт базы данных с помощью управляемого удостоверения для проверки подлинности по приватной ссылке

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

Эта команда создает запрос экспорта для указанной базы данных с помощью управляемого удостоверения для проверки подлинности с подключением через приватный канал.

Параметры

-AdministratorLogin

Указывает имя администратора SQL.

Если -AuthenticationType ManagedIdentity это указано, это должен быть полный идентификатор ресурса управляемого удостоверения, назначаемого пользователем, который является администратором Microsoft Entra сервера.

Свойства параметров

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-AdministratorLoginPassword

Указывает пароль администратора SQL.

Свойства параметров

Тип:	SecureString
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-AuthenticationType

Указывает тип проверки подлинности, используемый для доступа к серверу. Значение по умолчанию — SQL, если тип проверки подлинности не задан. Допустимые значения для этого параметра:

• Sql. Проверка подлинности SQL. Задайте администратору AdministratorLogin и AdministratorLoginPassword имя пользователя и пароль администратора SQL.
• ADPassword. Проверка подлинности Microsoft Entra. Задайте администратору AdministratorLogin и AdministratorLoginPassword имя пользователя и пароль администратора Microsoft Entra. Этот параметр доступен только на серверах Базы данных SQL версии 12.
• ManagedIdentity. Проверка подлинности управляемого удостоверения. Используйте управляемое удостоверение, назначаемое пользователем, для проверки подлинности с помощью SQL Server. Управляемое удостоверение должно быть администратором Microsoft Entra для сервера.

Свойства параметров

Тип:	AuthenticationType
Default value:	None
Допустимые значения:	None, Sql, AdPassword, ManagedIdentity
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметров

Тип:	SwitchParameter
Default value:	False
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	cf

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-DatabaseName

Указывает имя базы данных SQL.

Свойства параметров

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	2
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure

Свойства параметров

Тип:	IAzureContextContainer
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	AzContext, AzureRmContext, AzureCredential

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-ResourceGroupName

Указывает имя группы ресурсов для сервера базы данных SQL.

Свойства параметров

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	0
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-ServerName

Указывает имя сервера базы данных SQL.

Свойства параметров

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	1
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	True
Значение из оставшихся аргументов:	False

-SqlServerResourceIdForPrivateLink

Идентификатор ресурса SQL Server для создания приватного канала

Свойства параметров

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-StorageAccountResourceIdForPrivateLink

Идентификатор ресурса учетной записи хранения для создания приватного канала

Свойства параметров

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-StorageKey

Указывает ключ доступа для учетной записи хранения.

Если -StorageKeyType ManagedIdentity это указано, это должен быть полный идентификатор ресурса управляемого удостоверения, назначаемого пользователем, который имеет доступ на запись в учетной записи хранения для предоставленного storageUri (например, с помощью назначения роли участника данных BLOB-объектов хранилища ).

Свойства параметров

Тип:	String
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-StorageKeyType

Указывает тип ключа доступа для учетной записи хранения. Допустимые значения для этого параметра:

• StorageAccessKey. Это значение использует ключ учетной записи хранения.
• SharedAccessKey. Это значение использует ключ подписанного URL-адреса (SAS).
• ManagedIdentity. Используйте управляемое удостоверение, назначаемое пользователем, для проверки подлинности с учетной записью хранения.

Свойства параметров

Тип:	StorageKeyType
Default value:	None
Допустимые значения:	StorageAccessKey, SharedAccessKey, ManagedIdentity
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-StorageUri

Командлет New-AzSqlDatabaseExport экспортирует базу данных SQL Azure в виде BACPAC-файла в учетную запись хранения. Запрос состояния базы данных экспорта может быть отправлен для получения сведений о состоянии этого запроса. Этот командлет также поддерживается в службе SQL Server Stretch Database в Azure.

Это важно

Чтобы использовать этот командлет брандмауэра на сервере SQL Server Azure, необходимо настроить параметр "Разрешить службам и ресурсам Azure доступ к этому серверу". Если это не настроено, будут возникать ошибки GatewayTimeout. Это не обязательно, если подключение приватного канала установлено с помощью параметра UseNetworkIsolation.

Свойства параметров

Тип:	Uri
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	True
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-UseNetworkIsolation

Если задано, создайте приватную ссылку для учетной записи хранения и (или) SQL Server

Свойства параметров

Тип:	Boolean
Default value:	None
Поддерживаются подстановочные знаки:	False
DontShow:	False

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

Свойства параметров

Тип:	SwitchParameter
Default value:	False
Поддерживаются подстановочные знаки:	False
DontShow:	False
Aliases:	wi

Наборы параметров

(All)

Position:	Named
Обязательно:	False
Значение из конвейера:	False
Значение из конвейера по имени свойства:	False
Значение из оставшихся аргументов:	False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Входные данные

String

Выходные данные

AzureSqlDatabaseImportExportBaseModel

Примечания

• Ключевые слова: azure, azurerm, arm, resource, management, manager, sql, database, mssql

Связанные ссылки

• Get-AzSqlDatabaseImportExportStatus
• New-AzSqlDatabaseImport
• Документация по базе данных SQL