Invoke-AzStorageAccountFailover

Modul:

Az.Storage Module

Vyvolá převzetí služeb při selhání účtu úložiště.

Syntax

AccountName (Výchozí)

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

Vyvolá převzetí služeb při selhání účtu úložiště. Žádost o převzetí služeb při selhání se dá aktivovat pro účet úložiště v případě problémů s dostupností. Převzetí služeb při selhání probíhá z primárního clusteru účtu úložiště do sekundárního clusteru pro účty RA-GRS. Sekundární cluster se stane primárním po převzetí služeb při selhání. Než zahájíte převzetí služeb při selhání, seznamte se s následujícím dopadem na váš účet úložiště: 1.1. Zkontrolujte čas poslední synchronizace pomocí statistik služby GET Blob Service (https://learn.microsoft.com/rest/api/storageservices/get-blob-service-stats), statistik služby GET Table Service (https://learn.microsoft.com/rest/api/storageservices/get-table-service-stats) a statistik služby GET Queue Service (https://learn.microsoft.com/rest/api/storageservices/get-queue-service-stats) pro váš účet. Jedná se o data, která můžete ztratit, pokud zahájíte převzetí služeb při selhání. 2. Po převzetí služeb při selhání se typ vašeho účtu úložiště převede na místně redundantní úložiště (LRS). Účet můžete převést tak, aby používal geograficky redundantní úložiště (GRS). 3. Jakmile znovu povolíte GRS pro účet úložiště, Microsoft replikuje data do nové sekundární oblasti. Doba replikace závisí na množství dat, která se mají replikovat. Upozorňujeme, že za bootstrap se účtují poplatky za šířku pásma. https://azure.microsoft.com/en-us/pricing/details/bandwidth/

Příklady

Příklad 1: Vyvolání neplánovaného převzetí služeb při selhání účtu úložiště

$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

Tento příkaz zkontroluje čas poslední synchronizace účtu úložiště a potom vyvolá převzetí služeb při selhání, sekundární cluster se po převzetí služeb při selhání stane primárním. Vzhledem k tomu, že převzetí služeb při selhání trvá dlouho, doporučujeme ho spustit v back-endu s parametrem -Asjob a pak počkat na dokončení úlohy.

Příklad 2: Vyvolání plánovaného převzetí služeb při selhání účtu úložiště

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

Tento příkaz zkontroluje čas poslední synchronizace a můžefailover stav účtu úložiště a pak vyvolá plánované převzetí služeb při selhání.

Příklad 3: Vyvolání neplánovaného převzetí služeb při selhání účtu úložiště s typem převzetí služeb při selhání nastaveným na Neplánované

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

Tento příkaz zkontroluje čas poslední synchronizace a můžefailover stavu účtu úložiště a pak vyvolá neplánované převzetí služeb při selhání.

Parametry

-AsJob

Spuštění rutiny na pozadí

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	viz

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Vlastnosti parametru

Typ:	IAzureContextContainer
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-FailoverType

Zadejte typ převzetí služeb při selhání. Možné hodnoty jsou: Neplánované, Plánované. Pokud není zadaný, výchozí typ převzetí služeb při selhání je neplánovaný.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Force

Vynucení převzetí služeb při selhání účtu

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-InputObject

Objekt účtu úložiště

Vlastnosti parametru

Typ:	PSStorageAccount
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

AccountObject

Position:	Named
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Name

Název účtu úložiště

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	název_účtu_úložiště, Název účtu

Sady parametrů

AccountName

Position:	1
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ResourceGroupName

Název skupiny prostředků

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

AccountName

Position:	0
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Wi

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

PSStorageAccount

Výstupy

PSStorageAccount