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

Description

New-AzSqlDatabaseExport cmdlet은 Azure SQL Database를 .bacpac 파일로 스토리지 계정으로 내보냅니다. 이 요청에 대한 상태 정보를 검색하기 위해 내보내기 데이터베이스 상태 가져오기 요청을 보낼 수 있습니다. 또한 이 cmdlet은 Azure의 SQL Server Stretch Database 서비스에서도 지원됩니다.

중요합니다

이 cmdlet을 사용하려면 Azure SQL Server의 방화벽을 "Azure 서비스 및 리소스가 이 서버에 액세스할 수 있도록 허용"하도록 구성해야 합니다. 구성되지 않은 경우 GatewayTimeout 오류가 발생합니다. Private Link 연결이 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: 프라이빗 링크를 통한 인증에 관리 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
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 Database V12 서버에서만 사용할 수 있습니다.
ManagedIdentity. 관리 ID 인증. 사용자가 할당한 관리 ID를 사용하여 SQL Server로 인증합니다. 관리 ID는 서버에 대한 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
별칭:	cf(cf)

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-DatabaseName

SQL Database의 이름을 지정합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	2
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독

매개 변수 속성

형식:	IAzureContextContainer
Default value:	None
와일드카드 지원:	False
DontShow:	False
별칭:	AzContext, AzureRmContext, AzureCredential

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ResourceGroupName

SQL Database 서버에 대한 리소스 그룹의 이름을 지정합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	0
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-ServerName

SQL Database 서버의 이름을 지정합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	1
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-SqlServerResourceIdForPrivateLink

프라이빗 링크를 만들 SQL Server 리소스 ID

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-StorageAccountResourceIdForPrivateLink

프라이빗 링크를 만들 스토리지 계정 리소스 ID

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-StorageKey

스토리지 계정에 대한 액세스 키를 지정합니다.

제공된 경우 -StorageKeyType ManagedIdentity 제공된 StorageUri에 대한 스토리지 계정에 대한 쓰기 액세스 권한이 있는 사용자 할당 관리 ID의 전체 리소스 ID여야 합니다(예: Storage Blob 데이터 기여자 역할 할당을 통해).

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-StorageKeyType

스토리지 계정의 액세스 키 유형을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

StorageAccessKey. 이 값은 스토리지 계정 키를 사용합니다.
SharedAccessKey. 이 값은 SAS(공유 액세스 서명) 키를 사용합니다.
ManagedIdentity. 스토리지 계정으로 인증하려면 사용자 할당 관리 ID를 사용합니다.

매개 변수 속성

형식:	StorageKeyType
Default value:	None
허용되는 값:	StorageAccessKey, SharedAccessKey, ManagedIdentity
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-StorageUri

중요합니다

매개 변수 속성

형식:	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

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False
별칭:	위스콘신

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

String

출력

AzureSqlDatabaseImportExportBaseModel

참고

키워드: azure, azurerm, arm, 리소스, 관리, 관리자, sql, 데이터베이스, mssql

피드백

이 페이지가 도움이 되었나요?

다음을 통해 공유

New-AzSqlDatabaseExport

구문

Default (기본값)

Description

예제

예제 1: 데이터베이스에 대한 내보내기 요청 만들기

예제 2: 프라이빗 링크를 통한 인증에 관리 ID를 사용하여 데이터베이스에 대한 내보내기 요청 만들기

매개 변수

-AdministratorLogin

매개 변수 속성

매개 변수 집합

-AdministratorLoginPassword

매개 변수 속성

매개 변수 집합

-AuthenticationType

매개 변수 속성

매개 변수 집합

-Confirm

매개 변수 속성

매개 변수 집합

-DatabaseName

매개 변수 속성

매개 변수 집합

-DefaultProfile

매개 변수 속성

매개 변수 집합

-ResourceGroupName

매개 변수 속성

매개 변수 집합

-ServerName

매개 변수 속성

매개 변수 집합

-SqlServerResourceIdForPrivateLink

매개 변수 속성

매개 변수 집합

-StorageAccountResourceIdForPrivateLink

매개 변수 속성

매개 변수 집합

-StorageKey

매개 변수 속성

매개 변수 집합

-StorageKeyType

매개 변수 속성

매개 변수 집합

-StorageUri

매개 변수 속성

매개 변수 집합

-UseNetworkIsolation

매개 변수 속성

매개 변수 집합

-WhatIf

매개 변수 속성

매개 변수 집합

CommonParameters

입력

String

출력

AzureSqlDatabaseImportExportBaseModel

참고

관련 링크

피드백