다음을 통해 공유


PowerShell을 사용하여 단일 쓰기 지역이 있는 Azure Cosmos DB 계정에 대한 장애 조치(failover) 우선 순위 변경 또는 장애 조치(failover) 트리거

적용 대상: NoSQL MongoDB Cassandra Gremlin 테이블

참고 항목

Azure Az PowerShell 모듈을 사용하여 Azure와 상호 작용하는 것이 좋습니다. 시작하려면 Azure PowerShell 설치를 참조하세요. Az PowerShell 모듈로 마이그레이션하는 방법에 대한 자세한 내용은 Azure PowerShell을 AzureRM에서 Azure로 마이그레이션을 참조하세요.

이 샘플에는 Azure PowerShell Az 5.4.0 이상이 필요합니다. Get-Module -ListAvailable Az를 실행하여 설치된 버전을 확인합니다. 설치해야 하는 경우 Azure PowerShell 모듈 설치를 참조하세요.

Connect-AzAccount를 실행하여 Azure에 로그인합니다.

샘플 스크립트

참고 항목

failoverPriority=0이 포함된 지역에 대한 변경 내용은 수동 장애 조치(failover)를 트리거하고 수동 장애 조치(failover)를 위해 구성된 계정으로만 수행할 수 있습니다. 다른 모든 지역에 대한 변경 내용은 Azure Cosmos DB 계정의 장애 조치(failover) 우선 순위를 변경하기만 하면 됩니다.

참고 항목

이 샘플에서는 API for NoSQL 계정을 사용하는 방법을 보여 줍니다. 이 샘플을 다른 API에 사용하려면 관련 속성을 복사하고 API별 스크립트에 적용합니다.

# Reference: Az.CosmosDB | https://docs.microsoft.com/powershell/module/az.cosmosdb
# --------------------------------------------------
# Purpose
# Update Cosmos DB account: Change region failover priority.
# Note: updating location at priority 0 triggers a failover to the new location
# --------------------------------------------------
# Variables - ***** SUBSTITUTE YOUR VALUES *****
$resourceGroupName = "myResourceGroup" # Resource Group must already exist
$accountName = "myaccount" # Must be all lower case
$locations = @("West US", "East US") # Regions ordered by UPDATED failover priority
# --------------------------------------------------

# Get existing Cosmos DB account
$account = Get-AzCosmosDBAccount -ResourceGroupName $resourceGroupName -Name $accountName

# Update account failover priority
Update-AzCosmosDBAccountFailoverPriority -InputObject $account -FailoverPolicy $locations

배포 정리

스크립트 샘플을 실행한 후에 다음 명령을 사용하여 리소스 그룹 및 관련된 모든 리소스를 제거할 수 있습니다.

Remove-AzResourceGroup -ResourceGroupName "myResourceGroup"

스크립트 설명

이 스크립트는 다음 명령을 사용합니다. 테이블에 있는 각 명령은 명령에 해당하는 문서에 연결됩니다.

명령 주의
Azure Cosmos DB
Get-AzCosmosDBAccount Azure Cosmos DB 계정을 나열하거나 지정된 Azure Cosmos DB 계정을 가져옵니다.
Update-AzCosmosDBAccountFailoverPriority Azure Cosmos DB 계정 지역의 장애 조치(failover) 우선 순위 순서를 업데이트합니다.
Azure 리소스 그룹
Remove-AzResourceGroup 모든 중첩 리소스를 포함한 리소스 그룹을 삭제합니다.

다음 단계

Azure PowerShell에 대한 자세한 내용은 Azure PowerShell 설명서를 참조하세요.