Invoke-AzStorageAccountFailover

Invoke-AzStorageAccountFailover
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-FailoverType <String>]
    [-Force]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Invoke-AzStorageAccountFailover
    -InputObject <PSStorageAccount>
    [-FailoverType <String>]
    [-Force]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Invoca failover de uma conta de armazenamento. A solicitação de failover pode ser acionada para uma conta de armazenamento em caso de problemas de disponibilidade. O failover ocorre do cluster primário da conta de armazenamento para o cluster secundário para RA-GRS contas. O cluster secundário se tornará primário após o failover. Entenda o seguinte impacto na sua conta de armazenamento antes de iniciar o failover: 1.1. Verifique a Última Hora de Sincronização usando 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) e GET Queue Service Stats (https://learn.microsoft.com/rest/api/storageservices/get-queue-service-stats) para sua conta. Esses são os dados que você pode perder se iniciar o failover. 2.Após o failover, o tipo de conta de armazenamento será convertido em LRS (armazenamento com redundância local). Você pode converter sua conta para usar armazenamento com redundância geográfica (GRS). 3.Depois de reativar o GRS para sua conta de armazenamento, a Microsoft replicará os dados para sua nova região secundária. O tempo de replicação depende da quantidade de dados a serem replicados. Por favor, note que há taxas de largura de banda para o bootstrap. https://azure.microsoft.com/en-us/pricing/details/bandwidth/

$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

Este comando verifica a última hora de sincronização de uma conta de armazenamento e, em seguida, invoca o failover dela, o cluster secundário se tornará primário após o failover. Como o failover leva muito tempo, sugira executá-lo no back-end com -Asjob parâmetro e, em seguida, aguarde a conclusão do trabalho.

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

Este comando verifica o último tempo de sincronização e o estado do canFailover de uma conta de Armazenamento e depois invoca um failover planeado dessa conta.

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

Este comando verifica o último tempo de sincronização e o estado canFailover de uma conta de armazenamento e depois invoca um failover não planeado dessa conta.

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.