次の方法で共有

New-AzSqlDatabaseExport

モジュール:
Az.Sql Module

Azure SQL Database を .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 コマンドレットは、Azure SQL Database を .bacpac ファイルとしてストレージ アカウントにエクスポートします。 データベースの状態の取得要求を送信して、この要求の状態情報を取得できます。 このコマンドレットは、Azure 上の SQL Server Stretch Database サービスでもサポートされています。

Important

このコマンドレットを使用するには、Azure SQL Server 上のファイアウォールを "Azure サービスとリソースにこのサーバーへのアクセスを許可する" ように構成する必要があります。 これが構成されていない場合、GatewayTimeout エラーが発生します。 これは、UseNetworkIsolation パラメーターを使用して Private Link 接続が確立されている場合は必要ありません。

例

例 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: プライベート リンク経由の認証にマネージド ID を使用してデータベースのエクスポート要求を作成する

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

このコマンドは、Private Link 経由の接続を使用した認証にマネージド ID を使用して、指定されたデータベースのエクスポート要求を作成します。

パラメーター

-AdministratorLogin

SQL 管理者の名前を指定します。

-AuthenticationType ManagedIdentityが指定されている場合、これは、サーバーの Microsoft Entra 管理者であるユーザー割り当てマネージド ID の完全なリソース ID である必要があります。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-AdministratorLoginPassword

SQL 管理者のパスワードを指定します。

パラメーターのプロパティ

型:SecureString
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-AuthenticationType

サーバーへのアクセスに使用する認証の種類を指定します。 認証の種類が設定されていない場合、既定値は SQL です。 このパラメーターに使用できる値は次のとおりです。

  • Sql。 SQL 認証。 AdministratorLogin と AdministratorLoginPassword を SQL 管理者のユーザー名とパスワードに設定します。
  • ADPassword。 Microsoft Entra 認証。 AdministratorLogin と AdministratorLoginPassword を Microsoft Entra 管理者のユーザー名とパスワードに設定します。 このパラメーターは、SQL Database V12 サーバーでのみ使用できます。
  • ManagedIdentity。 マネージド ID 認証。 SQL サーバーで認証するには、ユーザー割り当てマネージド ID を使用します。 マネージド ID は、サーバーの Microsoft Entra 管理者 である必要があります。

パラメーターのプロパティ

型:AuthenticationType
規定値:None
指定可能な値:None, Sql, AdPassword, ManagedIdentity
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

パラメーターのプロパティ

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DatabaseName

SQL Database の名前を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:2
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション

パラメーターのプロパティ

型:IAzureContextContainer
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ResourceGroupName

SQL Database サーバーのリソース グループの名前を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:0
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-ServerName

SQL Database サーバーの名前を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:1
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-SqlServerResourceIdForPrivateLink

プライベート リンクを作成する SQL Server リソース ID

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-StorageAccountResourceIdForPrivateLink

プライベート リンクを作成するストレージ アカウントのリソース ID

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False
(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-StorageKey

ストレージ アカウントのアクセス キーを指定します。

-StorageKeyType ManagedIdentityが指定されている場合、これは、指定された StorageUri のストレージ アカウントに対する書き込みアクセス権を持つユーザー割り当てマネージド ID の完全なリソース ID である必要があります (たとえば、ストレージ BLOB データ共同作成者ロールの割り当て)。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-StorageKeyType

ストレージ アカウントのアクセス キーの種類を指定します。 このパラメーターに使用できる値は次のとおりです。

  • StorageAccessKey。 この値はストレージ アカウント キーを使用します。
  • SharedAccessKey。 この値は Shared Access Signature (SAS) キーを使用します。
  • ManagedIdentity。 ストレージ アカウントでの認証には、ユーザー割り当てマネージド ID を使用します。

パラメーターのプロパティ

型:StorageKeyType
規定値:None
指定可能な値:StorageAccessKey, SharedAccessKey, ManagedIdentity
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-StorageUri

New-AzSqlDatabaseExport コマンドレットは、Azure SQL Database を .bacpac ファイルとしてストレージ アカウントにエクスポートします。 データベースの状態の取得要求を送信して、この要求の状態情報を取得できます。 このコマンドレットは、Azure 上の SQL Server Stretch Database サービスでもサポートされています。

Important

このコマンドレットを使用するには、Azure SQL Server 上のファイアウォールを "Azure サービスとリソースにこのサーバーへのアクセスを許可する" ように構成する必要があります。 これが構成されていない場合、GatewayTimeout エラーが発生します。 これは、UseNetworkIsolation パラメーターを使用して Private Link 接続が確立されている場合は必要ありません。

パラメーターのプロパティ

型:Uri
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-UseNetworkIsolation

設定されている場合、ストレージ アカウントまたは SQL サーバーのプライベート リンクが作成されます

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:ウィスコンシン

パラメーター セット

(All)
配置: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, リソース, 管理, マネージャー, sql, データベース, mssql