New-AzSqlDatabaseSecondary
기존 데이터베이스에 대한 보조 데이터베이스를 만들고 데이터 복제를 시작합니다.
구문
New-AzSqlDatabaseSecondary
[-DatabaseName] <String>
[-SecondaryServiceObjectiveName <String>]
[-SecondaryElasticPoolName <String>]
[-Tags <Hashtable>]
-PartnerResourceGroupName <String>
-PartnerServerName <String>
[-PartnerDatabaseName <String>]
[-AllowConnections <AllowConnections>]
[-AsJob]
[-LicenseType <String>]
[-BackupStorageRedundancy <String>]
[-SecondaryType <String>]
[-HighAvailabilityReplicaCount <Int32>]
[-ZoneRedundant]
[-AssignIdentity]
[-EncryptionProtector <String>]
[-UserAssignedIdentityId <String[]>]
[-KeyList <String[]>]
[-FederatedClientId <Guid>]
[-EncryptionProtectorAutoRotation]
[-ServerName] <String>
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-AzSqlDatabaseSecondary
[-DatabaseName] <String>
[-Tags <Hashtable>]
-PartnerResourceGroupName <String>
-PartnerServerName <String>
[-PartnerDatabaseName <String>]
[-AllowConnections <AllowConnections>]
[-AsJob]
-SecondaryComputeGeneration <String>
-SecondaryVCore <Int32>
[-SecondaryComputeModel <String>]
[-LicenseType <String>]
[-AutoPauseDelayInMinutes <Int32>]
[-MinimumCapacity <Double>]
[-BackupStorageRedundancy <String>]
[-SecondaryType <String>]
[-HighAvailabilityReplicaCount <Int32>]
[-ZoneRedundant]
[-AssignIdentity]
[-EncryptionProtector <String>]
[-UserAssignedIdentityId <String[]>]
[-KeyList <String[]>]
[-FederatedClientId <Guid>]
[-EncryptionProtectorAutoRotation]
[-ServerName] <String>
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
New-AzSqlDatabaseSecondary cmdlet은 데이터베이스에 대한 지역 복제를 설정하는 데 사용할 때 Start-AzSqlDatabaseCopy cmdlet을 대체합니다. 주 데이터베이스에서 보조 데이터베이스로 지역 복제 링크 개체를 반환합니다.
예제
예제 1: 활성 Geo-Replication 설정
$database = Get-AzSqlDatabase -DatabaseName $databasename -ResourceGroupName $primaryresourcegroupname -ServerName $primaryservername
$database | New-AzSqlDatabaseSecondary -PartnerResourceGroupName $secondaryresourcegroupname -PartnerServerName $secondaryservername -AllowConnections "All"
예제 2: 활성 Geo-Replication 설정하고 원본 데이터베이스 이름과 다른 파트너 데이터베이스 이름을 지정합니다.
$database = Get-AzSqlDatabase -DatabaseName $databasename -ResourceGroupName $primaryresourcegroupname -ServerName $primaryservername
$database | New-AzSqlDatabaseSecondary -PartnerResourceGroupName $secondaryresourcegroupname -PartnerServerName $secondaryservername -PartnerDatabaseName $secondarydatabasename -AllowConnections "All"
매개 변수
-AllowConnections
보조 Azure SQL Database의 읽기 의도를 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.
- 아니요
- 모두
형식: | AllowConnections |
허용되는 값: | No, All |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-AsJob
백그라운드에서 cmdlet 실행
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-AssignIdentity
Azure KeyVault와 같은 키 관리 서비스에 사용할 이 데이터베이스에 대한 Microsoft Entra ID를 생성하고 할당합니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-AutoPauseDelayInMinutes
데이터베이스에 대한 자동 일시 중지 지연 시간(서버리스만 해당) -1 옵트아웃
형식: | Int32 |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-BackupStorageRedundancy
SQL Database에 대한 백업을 저장하는 데 사용되는 Backup 스토리지 중복성입니다. 옵션은 로컬, 영역 및 지역입니다.
형식: | String |
허용되는 값: | Local, Zone, Geo, GeoZone |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
형식: | SwitchParameter |
별칭: | cf |
Position: | Named |
Default value: | False |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DatabaseName
주 데이터베이스 역할을 할 데이터베이스의 이름을 지정합니다.
형식: | String |
Position: | 2 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독
형식: | IAzureContextContainer |
별칭: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-EncryptionProtector
SQL Database 복사에 대한 암호화 보호기 키입니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-EncryptionProtectorAutoRotation
AKV 키 자동 회전 상태
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-FederatedClientId
SQL Database의 페더레이션된 클라이언트 ID입니다. 테넌트 간 CMK 시나리오에 사용됩니다.
형식: | Nullable<T>[Guid] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-HighAvailabilityReplicaCount
읽기 전용 애플리케이션 의도 연결을 라우팅할 수 있는 데이터베이스와 연결된 읽기 전용 보조 복제본의 수입니다. 이 속성은 하이퍼스케일 버전 데이터베이스에 대해서만 설정할 수 있습니다.
형식: | Int32 |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-KeyList
SQL Database 복사본에 대한 AKV 키 목록입니다.
형식: | String[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-LicenseType
Azure Sql 데이터베이스의 라이선스 유형입니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-MinimumCapacity
일시 중지되지 않은 경우 보조 데이터베이스가 항상 할당한 최소 용량입니다. 서버리스 Azure Sql 데이터베이스에만 해당합니다.
형식: | Double |
별칭: | MinVCore, MinCapacity |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-PartnerDatabaseName
만들 보조 데이터베이스의 이름입니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-PartnerResourceGroupName
이 cmdlet이 보조 데이터베이스를 할당하는 Azure 리소스 그룹의 이름을 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-PartnerServerName
보조 역할을 할 Azure SQL 데이터베이스 서버의 이름을 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-PartnerSubscriptionId
원본과 다른 경우 Azure SQL 데이터베이스 서버의 구독을 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ResourceGroupName
이 cmdlet이 주 데이터베이스를 할당하는 Azure 리소스 그룹의 이름을 지정합니다.
형식: | String |
Position: | 0 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-SecondaryComputeGeneration
Azure Sql Database 보조 복제본의 컴퓨팅 생성입니다.
형식: | String |
별칭: | Family |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-SecondaryComputeModel
Azure Sql Database 보조에 대한 컴퓨팅 모델입니다. 서버리스 또는 프로비전됨
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-SecondaryElasticPoolName
보조 데이터베이스를 배치할 탄력적 풀의 이름을 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-SecondaryServiceObjectiveName
보조 데이터베이스에 할당할 서비스 목표의 이름을 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-SecondaryType
보조 데이터베이스인 경우 데이터베이스의 보조 형식입니다. 유효한 값은 Geo, Named 및 Standby입니다.
형식: | String |
허용되는 값: | Named, Geo, Standby |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-SecondaryVCore
Azure Sql Database 보조 데이터베이스의 Vcore 번호입니다.
형식: | Int32 |
별칭: | Capacity |
Position: | Named |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ServerName
주 SQL Database의 SQL Server 이름을 지정합니다.
형식: | String |
Position: | 1 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Tags
SQL Database 복제 링크와 연결할 해시 테이블 형식의 키-값 쌍을 지정합니다. 예: @{key0="value0"; key1=$null; key2="value2"}
형식: | Hashtable |
별칭: | Tag |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-UserAssignedIdentityId
SQL Database 복사본에 대한 사용자 할당 ID 목록입니다.
형식: | String[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.
형식: | SwitchParameter |
별칭: | wi |
Position: | Named |
Default value: | False |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-ZoneRedundant
Azure Sql Database와 연결할 영역 중복성입니다. 이 속성은 하이퍼스케일 버전 데이터베이스에 대해서만 설정할 수 있습니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
입력
출력
관련 링크
Azure PowerShell