Freigeben über


Invoke-AzStorageAccountFailover

Ruft ein Failover eines Speicherkontos auf.

Syntax

AccountName (Standard)

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

Beschreibung

Ruft ein Failover eines Speicherkontos auf. Failoveranforderung kann bei Verfügbarkeitsproblemen für ein Speicherkonto ausgelöst werden. Das Failover erfolgt vom primären Cluster des Speicherkontos zum sekundären Cluster für RA-GRS Konten. Der sekundäre Cluster wird nach dem Failover primär. Beachten Sie die folgenden Auswirkungen auf Ihr Speicherkonto, bevor Sie das Failover initiieren: 1.1. Überprüfen Sie die letzte Synchronisierungszeit mit 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) und GET Queue Service Stats (https://learn.microsoft.com/rest/api/storageservices/get-queue-service-stats) für Ihr Konto. Dies sind die Daten, die beim Initiieren des Failovers verloren gehen können. 2.Nach dem Failover wird Ihr Speicherkontotyp in lokal redundanten Speicher (LRS) konvertiert. Sie können Ihr Konto so konvertieren, dass georedundanter Speicher (GRS) verwendet wird. 3.Sobald Sie GRS für Ihr Speicherkonto erneut aktivieren, repliziert Microsoft Daten in Ihre neue sekundäre Region. Die Replikationszeit hängt von der Datenmenge ab, die repliziert werden soll. Bitte beachten Sie, dass für den Bootstrap Bandbreitengebühren anfallen. https://azure.microsoft.com/en-us/pricing/details/bandwidth/

Beispiele

Beispiel 1: Aufrufen eines ungeplanten Failovers eines Speicherkontos

$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

Mit diesem Befehl wird die letzte Synchronisierungszeit eines Speicherkontos überprüft und dann ein Failover aufgerufen, der sekundäre Cluster wird nach dem Failover primär. Da failover eine lange Zeit dauert, schlagen Sie vor, sie im Back-End mit -Asjob Parameter auszuführen, und warten Sie dann, bis der Auftrag abgeschlossen ist.

Beispiel 2: Aufrufen eines geplanten Failovers eines Speicherkontos

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

Mit diesem Befehl wird die letzte Synchronisierungszeit überprüft und der Status eines Speicherkontos kannfailover ausgeführt und anschließend ein geplantes Failover aufgerufen.

Beispiel 3: Aufrufen eines ungeplanten Failovers eines Speicherkontos, bei dem FailoverType auf "Ungeplant" festgelegt ist

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

Mit diesem Befehl wird die letzte Synchronisierungszeit überprüft und der Status eines Speicherkontos kannfailover ausgeführt und anschließend ein ungeplantes Failover aufgerufen.

Parameter

-AsJob

Cmdlet im Hintergrund ausführen

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-FailoverType

Geben Sie den Failovertyp an. Mögliche Werte sind: Ungeplant, geplant. Wenn nicht angegeben, ist der Standardfailovertyp nicht geplant.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Force

Erzwingen des Failovers des Kontos

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-InputObject

Speicherkontoobjekt

Parametereigenschaften

Typ:PSStorageAccount
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

AccountObject
Position:Named
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Speicherkontoname.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Speicherkontoname, Kontoname

Parametersätze

AccountName
Position:1
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ResourceGroupName

Ressourcengruppenname.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

AccountName
Position:0
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

PSStorageAccount

Ausgaben

PSStorageAccount