[Storage] Storage account planned failover GA

[yifanz7]

Description

Mandatory Checklist

• Please choose the target release of Azure PowerShell. (⚠️Target release is a different concept from API readiness. Please click below links for details.)

  • General release
  • Public preview
  • Private preview
  • Engineering build
  • No need for a release

• Check this box to confirm: I have read the Submitting Changes section of CONTRIBUTING.md and reviewed the following information:

• SHOULD update ChangeLog.md file(s) appropriately
  • Update src/{{SERVICE}}/{{SERVICE}}/ChangeLog.md.
    • A snippet outlining the change(s) made in the PR should be written under the ## Upcoming Release header in the past tense.
  • Should not change ChangeLog.md if no new release is required, such as fixing test case only.
• SHOULD regenerate markdown help files if there is cmdlet API change. Instruction
• SHOULD have proper test coverage for changes in pull request.
• SHOULD NOT adjust version of module manually in pull request

[azure-client-tools-bot-prd]

Thanks for your contribution! The pull request validation has started. Please revisit this comment for updated status.

[Copilot]

Pull Request Overview

This PR adds support for storage account planned failover in the Azure Storage PowerShell module, enhancing the existing failover functionality to include a new failover type parameter. The changes enable users to perform both planned and unplanned failovers while providing additional geo-replication statistics to help inform failover decisions.

Key changes:

• Added a new FailoverType parameter to Invoke-AzStorageAccountFailover cmdlet with support for "Planned" and "Unplanned" options
• Extended PSGeoReplicationStats model with three new properties: CanPlannedFailover, PostFailoverRedundancy, and PostPlannedFailoverRedundancy
• Updated help documentation with new examples demonstrating planned and unplanned failover scenarios

Reviewed Changes

Copilot reviewed 7 out of 8 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
Invoke-AzStorageAccountFailover.md	Updated cmdlet help to document the new FailoverType parameter and added examples for planned and unplanned failover scenarios
Get-AzStorageAccount.md	Added new example showing geo-replication stats retrieval and corrected grammar in existing example titles
StorageAccountBaseCmdlet.cs	Added AccountFailoverType struct to define Planned and Unplanned failover type constants
InvokeAzureStorageAccountFailover.cs	Implemented FailoverType parameter, added failover type validation logic, and refactored execution into separate method
PSGeoReplicationStats.cs	Extended model with three new geo-replication properties and refactored object initialization to use object initializer syntax
ChangeLog.md	Added changelog entry documenting the new planned failover feature
StorageAccountTests.ps1	Added assertions to verify new geo-replication stats properties in test

[github-actions]

‼️ DO NOT MERGE THIS PR ‼️
This PR was labeled "Do Not Merge" because it contains code change that cannot be merged. Please contact the reviewer for more information.