Invoke-AzStorageAccountFailover
Storage 계정의 장애 조치(failover)를 호출합니다.
구문
AccountName (기본값)
Invoke-AzStorageAccountFailover
[-ResourceGroupName] <String>
[-Name] <String>
[-FailoverType <String>]
[-Force]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
AccountObject
Invoke-AzStorageAccountFailover
-InputObject <PSStorageAccount>
[-FailoverType <String>]
[-Force]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
예제
예제 1: 스토리지 계정의 계획되지 않은 장애 조치(failover) 호출
$account = Get-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -IncludeGeoReplicationStats
$account.GeoReplicationStats
Status : Live
LastSyncTime : 10/21/2025 3:42:38 AM
CanFailover : True
CanPlannedFailover : True
PostFailoverRedundancy : Standard_LRS
PostPlannedFailoverRedundancy : Standard_GRS
$job = Invoke-AzStorageAccountFailover -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -Force -AsJob
$job | Wait-Job
이 명령은 Storage 계정의 마지막 동기화 시간을 확인한 다음 장애 조치(failover)를 호출합니다. 장애 조치(failover) 후 보조 클러스터가 기본 클러스터가 됩니다. 장애 조치(failover)는 시간이 오래 걸리므로 -Asjob 매개 변수를 사용하여 백 엔드에서 실행한 다음 작업이 완료되기를 기다리는 것이 좋습니다.
예제 2: 스토리지 계정의 계획된 장애 조치(failover) 호출
PS C:\>$account = Get-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -IncludeGeoReplicationStats
PS C:\>$account.GeoReplicationStats
Status : Live
LastSyncTime : 10/21/2025 3:42:38 AM
CanFailover : True
CanPlannedFailover : True
PostFailoverRedundancy : Standard_LRS
PostPlannedFailoverRedundancy : Standard_GRS
PS C:\>$job = Invoke-AzStorageAccountFailover -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -FailoverType Planned -Force -AsJob
PS C:\>$job | Wait-Job
이 명령은 스토리지 계정의 마지막 동기화 시간 및 canFailover 상태를 확인한 다음 계획된 장애 조치(failover)를 호출합니다.
예제 3: FailoverType이 계획되지 않음으로 설정된 스토리지 계정의 계획되지 않은 장애 조치(failover) 호출
PS C:\>$account = Get-AzStorageAccount -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -IncludeGeoReplicationStats
PS C:\>$account.GeoReplicationStats
Status : Live
LastSyncTime : 10/21/2025 3:42:38 AM
CanFailover : True
CanPlannedFailover : True
PostFailoverRedundancy : Standard_LRS
PostPlannedFailoverRedundancy : Standard_GRS
PS C:\>$job = Invoke-AzStorageAccountFailover -ResourceGroupName "MyResourceGroup" -Name "mystorageaccount" -FailoverType Unplanned -Force -AsJob
PS C:\>$job | Wait-Job
이 명령은 스토리지 계정의 마지막 동기화 시간 및 canFailover 상태를 확인한 다음 계획되지 않은 장애 조치(failover)를 호출합니다.
매개 변수
-AsJob
백그라운드에서 cmdlet 실행
매개 변수 속성
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
매개 변수 속성
형식: SwitchParameter
Default value: None
와일드카드 지원: False
DontShow: False
별칭: cf(cf)
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-DefaultProfile
Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.
매개 변수 속성
형식: IAzureContextContainer
Default value: None
와일드카드 지원: False
DontShow: False
별칭: AzContext, AzureRmContext, AzureCredential
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-FailoverType
장애 조치(failover) 유형을 지정합니다. 가능한 값은 계획되지 않음, 계획됨입니다. 지정하지 않으면 기본 장애 조치 유형이 계획되지 않습니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-Force
계정 장애 조치(failover) 강제 적용
매개 변수 속성
매개 변수 집합
(All)
Position: Named
필수: False
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
Storage 계정 개체
AccountObject
Position: Named
필수: True
파이프라인의 값: True
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-Name
스토리지 계정 이름입니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
별칭: 저장계정이름, 계정 이름
매개 변수 집합
AccountName
Position: 1
필수: True
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-ResourceGroupName
리소스 그룹 이름입니다.
매개 변수 속성
형식: String
Default value: None
와일드카드 지원: False
DontShow: False
매개 변수 집합
AccountName
Position: 0
필수: True
파이프라인의 값: False
속성 이름별 파이프라인의 값: False
나머지 인수의 값: False
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여 주세요.
cmdlet이 실행되지 않습니다.
매개 변수 속성
형식: SwitchParameter
Default value: None
와일드카드 지원: 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 를 참조하세요.
출력