[devcenter] Update control plane and data plane cmdlets for 2025-04-01-preview

[am-lim]

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.

[VeryEarly]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 3 pipeline(s).

[VeryEarly]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 3 pipeline(s).

[github-actions]

To the author of the pull request,
This PR was labeled "Contains Breaking Change" because breaking changes have been detected by the static analysis pipeline.

• According to our policy, breaking changes can only take place during major release and they must be preannounced.
• Please follow our guide on the detailed steps.
• Required: Please fill in the task below to facilitate our contact,you will receive notifications related to breaking changes.

[isra-fel]

Hi @am-lim you might want to get back to work on this pull request as we are approaching the breaking change window

[isra-fel]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 3 pipeline(s).

[isra-fel]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 3 pipeline(s).

[Copilot]

Pull Request Overview

This PR updates the Azure DevCenter PowerShell module to a new API version (2025-04-01-preview from 2024-05-01-preview). The changes include:

• Removal of deprecated Plan and PlanMember cmdlets and their associated functionality
• Introduction of new ProjectPolicy cmdlets to replace the removed Plan functionality
• Addition of new image definition build management cmdlets
• Updates to existing cmdlets with new parameters for enhanced functionality (active hours configuration, DevBox tunnel settings, workspace storage modes, etc.)
• API version updates across all help documentation and test files
• Breaking change exceptions documented for the removed functionality

Reviewed Changes

Copilot reviewed 210 out of 278 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
tools/StaticAnalysis/Exceptions/Az.DevCenter/BreakingChangeIssues.csv	Documents 158 breaking changes related to removed Plan properties and cmdlets
src/DevCenter/DevCenter/help/*.md (multiple files)	Updates API version references from 2024-05-01-preview to 2025-04-01-preview across all help documentation
src/DevCenter/DevCenter/help/Get-AzDevCenterAdminPlan.md	Removed - Plan cmdlet no longer exists
src/DevCenter/DevCenter/help/Get-AzDevCenterAdminProjectPolicy.md	New cmdlet to manage project policies (replacement for Plans)
src/DevCenter/DevCenter/help/New-AzDevCenterAdminProjectPolicy.md	New cmdlet for creating project policies
src/DevCenter/DevCenter/help/Update-AzDevCenterAdminProjectPolicy.md	New cmdlet for updating project policies
src/DevCenter/DevCenter/help/Remove-AzDevCenterAdminProjectPolicy.md	New cmdlet for deleting project policies
src/DevCenter/DevCenter/help/Build-AzDevCenterAdminProjectCatalogImageDefinitionImage.md	New cmdlet for building image definitions
src/DevCenter/DevCenter/help/Get-AzDevCenterAdminProjectCatalogImageDefinition*.md	New cmdlets for managing image definitions and builds
src/DevCenter/DevCenter/Az.DevCenter.psd1	Updates module manifest with new cmdlets and dependency version bump
src/DevCenter/DevCenter.AutoRest/test/*.ps1	Updates test file references to match new cmdlet names
src/DevCenter/DevCenter.AutoRest/test/deploymentTemplates/template.json	Updates ARM template API versions

[isra-fel]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 3 pipeline(s).

[isra-fel]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 3 pipeline(s).

[isra-fel]

/azp run

[azure-pipelines]

Azure Pipelines will not run the associated pipelines, because the pull request was updated after the run command was issued. Review the pull request again and issue a new run command.

[dolauli]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 3 pipeline(s).

[isra-fel]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 3 pipeline(s).

[isra-fel]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 3 pipeline(s).

[dolauli]

@am-lim, Could you help authorize a markdown like this for each of the breaking change? We'll need it for publishing migration guides. Just leave a comment in the issue would be fine. Thank you!

## Az.Accounts

### `Get-AzAccessToken`

The default output type is changed from `PSAccessToken` to `PSSecureAccessToken`.That is to change plaintext `PSAccessToken.Token` to `SecureString PSSecureAccessToken.Token`

#### Before
```powershell
$authHeader = @{
    'Content-Type'  = 'application/json'
    'Authorization' = 'Bearer ' + (Get-AccessToken).Token
}
$response = Invoke-RestMethod -Method Get -Headers $authHeader -Uri $uri
```

#### After
```powershell
$secureToken = (Get-AzAccessToken).Token
$ssPtr = [System.Runtime.InteropServices.Marshal]::SecureStringToBSTR($secureToken)
try {
     $plaintextToken = [System.Runtime.InteropServices.Marshal]::PtrToStringBSTR($ssPtr)
} 
finally {
     [System.Runtime.InteropServices.Marshal]::ZeroFreeBSTR($ssPtr) 
}
$authHeader = @{
    'Content-Type'  = 'application/json'
    'Authorization' = 'Bearer ' + $plaintextToken
}
$response = Invoke-RestMethod -Method Get -Headers $authHeader -Uri $uri
```

[isra-fel]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 3 pipeline(s).

[am-lim]

Breaking changes markdown:
DevCenterBreakingChanges2025-04-01-preview.md