Invoke-AzStorageAccountFailover

Modul:

Az.Storage Module

Memanggil failover akun Storage.

Sintaks

AccountName (Default)

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

Deskripsi

Memanggil failover akun Storage. Permintaan failover dapat dipicu untuk akun penyimpanan jika terjadi masalah ketersediaan. Failover terjadi dari kluster utama akun penyimpanan ke kluster sekunder untuk akun RA-GRS. Kluster sekunder akan menjadi primer setelah failover. Harap pahami dampak berikut ke akun penyimpanan Anda sebelum Anda memulai failover: 1.1. Silakan periksa Waktu Sinkronisasi Terakhir menggunakan Get Blob Service Stats (https://learn.microsoft.com/rest/api/storageservices/get-blob-service-stats), GET Table Service Stats (https://learn.microsoft.com/rest/api/storageservices/get-table-service-stats) dan GET Queue Service Stats (https://learn.microsoft.com/rest/api/storageservices/get-queue-service-stats) untuk akun Anda. Ini adalah data yang mungkin Hilang jika Anda memulai failover. 2.Setelah failover, jenis akun penyimpanan Anda akan dikonversi ke penyimpanan redundan lokal (LRS). Anda dapat mengonversi akun Anda untuk menggunakan penyimpanan geo-redundan (GRS). 3.Setelah Anda mengaktifkan kembali GRS untuk akun penyimpanan Anda, Microsoft akan mereplikasi data ke wilayah sekunder baru Anda. Waktu replikasi tergantung pada jumlah data yang akan direplikasi. Harap dicatat bahwa ada biaya bandwidth untuk bootstrap. https://azure.microsoft.com/en-us/pricing/details/bandwidth/

Contoh

Contoh 1: Memanggil failover akun Penyimpanan yang tidak direncanakan

$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

Perintah ini memeriksa waktu sinkronisasi terakhir akun Storage lalu memanggil failover, kluster sekunder akan menjadi primer setelah failover. Karena failover membutuhkan waktu lama, sarankan untuk menjalankannya di backend dengan parameter -Asjob, lalu tunggu pekerjaan selesai.

Contoh 2: Memanggil failover akun Penyimpanan yang direncanakan

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

Perintah ini memeriksa waktu sinkronisasi terakhir dan status canFailover dari akun Storage lalu memanggil failover yang direncanakan.

Contoh 3: Memanggil failover akun Penyimpanan yang tidak direncanakan dengan FailoverType diatur ke Tidak Direncanakan

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

Perintah ini memeriksa waktu sinkronisasi terakhir dan status canFailover dari akun Storage lalu memanggil failover yang tidak direncanakan.

Parameter

-AsJob

Jalankan cmdlet di latar belakang

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Confirm

Meminta konfirmasi sebelum menjalankan cmdlet.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	Cf

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

Properti parameter

Jenis:	IAzureContextContainer
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	AzContext, AzureRmContext, AzureCredential

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-FailoverType

Tentukan jenis failover. Nilai yang mungkin adalah: Tidak Direncanakan, Direncanakan. Jika tidak ditentukan, jenis failover default tidak direncanakan.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Force

Paksa Untuk Failover Akun

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-InputObject

Objek akun penyimpanan

Properti parameter

Jenis:	PSStorageAccount
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

AccountObject

Position:	Named
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Name

Nama Akun Penyimpanan.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	NamaAkunPenyimpanan, Nama Akun

Kumpulan parameter

AccountName

Position:	1
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-ResourceGroupName

Nama Grup Sumber Daya.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Kumpulan parameter

AccountName

Position:	0
Wajib:	True
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-WhatIf

Menunjukkan apa yang akan terjadi ketika cmdlet dijalankan. Cmdlet tidak dijalankan.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	wi

Kumpulan parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

PSStorageAccount

Output

PSStorageAccount