Compartir a través de

Invoke-AzStorageAccountFailover

Módulo:
Az.Storage Module

Invoca la conmutación por error de una cuenta de almacenamiento.

Sintaxis

AccountName (valor predeterminado) 

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

Invoca la conmutación por error de una cuenta de almacenamiento. La solicitud de conmutación por error se puede desencadenar para una cuenta de almacenamiento en caso de problemas de disponibilidad. La conmutación por error se produce desde el clúster principal de la cuenta de almacenamiento al clúster secundario para las cuentas de RA-GRS. El clúster secundario se convertirá en principal después de la conmutación por error. Comprenda el siguiente impacto en la cuenta de almacenamiento antes de iniciar la conmutación por error: 1.1. Compruebe la hora de la última sincronización mediante 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) y GET Queue Service Stats (https://learn.microsoft.com/rest/api/storageservices/get-queue-service-stats) para su cuenta. Estos son los datos que puede perder si inicia la conmutación por error. 2.Después de la conmutación por error, el tipo de cuenta de almacenamiento se convertirá en almacenamiento con redundancia local (LRS). Puede convertir su cuenta para usar almacenamiento con redundancia geográfica (GRS). 3.Una vez que vuelva a habilitar GRS para la cuenta de almacenamiento, Microsoft replicará los datos en la nueva región secundaria. El tiempo de replicación depende de la cantidad de datos que se van a replicar. Tenga en cuenta que hay cargos de ancho de banda por el arranque. https://azure.microsoft.com/en-us/pricing/details/bandwidth/

Ejemplos

Ejemplo 1: Invocar una conmutación por error no planeada de una cuenta de almacenamiento

$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 comprueba la última hora de sincronización de una cuenta de almacenamiento y, a continuación, invoca la conmutación por error, el clúster secundario se convertirá en principal después de la conmutación por error. Dado que la conmutación por error tarda mucho tiempo, sugiera ejecutarla en el back-end con -Asjob parámetro y, a continuación, espere a que se complete el trabajo.

Ejemplo 2: Invocar una conmutación por error planeada de una cuenta de almacenamiento

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 comprueba la hora de la última sincronización y el estado canFailover de una cuenta de almacenamiento y, a continuación, invoca una conmutación por error planeada.

Ejemplo 3: Invocación de una conmutación por error no planeada de una cuenta de almacenamiento con FailoverType establecido en No planeado

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 comprueba la hora de la última sincronización y el estado canFailover de una cuenta de almacenamiento y, a continuación, invoca una conmutación por error no planeada de ella.

Parámetros

-AsJob

Ejecución del cmdlet en segundo plano

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-FailoverType

Especifique el tipo de conmutación por error. Los valores posibles son: No planeado, Planeado. Si no se especifica, el tipo de conmutación por error predeterminado es No planeado.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Force

Forzar la conmutación por error de la cuenta

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-InputObject

Objeto de cuenta de almacenamiento

Propiedades de parámetro

Tipo:PSStorageAccount
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AccountObject
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Nombre de la cuenta de almacenamiento.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:NombreDeCuentaDeAlmacenamiento, Nombre de la cuenta

Conjuntos de parámetros

AccountName
Posición:1
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ResourceGroupName

Nombre del grupo de recursos.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AccountName
Posición:0
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

PSStorageAccount

Salidas

PSStorageAccount