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 o failover de uma conta de armazenamento. A solicitação de failover pode ser disparada 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 contas de RA-GRS. 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 Hora da Última Sincronização usando as Estatísticas do Serviço de Blob GET (https://learn.microsoft.com/rest/api/storageservices/get-blob-service-stats), as Estatísticas de Serviço de Tabela GET (https://learn.microsoft.com/rest/api/storageservices/get-table-service-stats) e as Estatísticas do Serviço get queue (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 GRS (armazenamento com redundância geográfica). 3.Depois de habilitar novamente o GRS para sua conta de armazenamento, Microsoft replicará os dados para sua nova região secundária. O tempo de replicação depende da quantidade de dados a serem replicados. Observe que há encargos de largura de banda para a inicialização. 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

Esse comando verifica a hora da última 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 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

Esse comando verifica a hora da última sincronização e o status canFailover de uma conta de Armazenamento e, em seguida, invoca um failover planejado dela.

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

Esse comando verifica a hora da última sincronização e o status canFailover de uma conta de Armazenamento e, em seguida, invoca um failover não planejado dela.

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.