Az.15.0.0 migration guide #28879
Az.15.0.0 migration guide #28879
Conversation
| Thanks for your contribution! The pull request validation has started. Please revisit this comment for updated status. |
There was a problem hiding this comment.
Pull Request Overview
This PR introduces a comprehensive migration guide for Az 15.0.0, documenting breaking changes across multiple Azure PowerShell modules. The guide helps users migrate their scripts and code from previous versions to Az 15.0.0.
Key changes:
- Documents deprecated and removed cmdlets and parameters across Az.Batch, Az.DevCenter, Az.FrontDoor, Az.Oracle, and Az.ServiceFabric modules
- Provides before/after migration examples for affected cmdlets
- Lists modules migrated from AutoRest v3 to v4 with potential breaking changes
| $certificate = -Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSCertificate" | ||
| $certificatesRef = -Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSCertificateReferenceNew" -ArgumentList @($certificate) |
There was a problem hiding this comment.
Missing 'New-Object' cmdlet name. The lines should be $certificate = New-Object -TypeName ... and $certificatesRef = New-Object -TypeName ...
| $certificate = -Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSCertificate" | |
| $certificatesRef = -Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSCertificateReferenceNew" -ArgumentList @($certificate) | |
| $certificate = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSCertificate" | |
| $certificatesRef = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSCertificateReferenceNew" -ArgumentList @($certificate) |
| $certificate = -Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSCertificate" | ||
| $certificatesRef = -Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSCertificateReferenceNew" -ArgumentList @($certificate) |
There was a problem hiding this comment.
Missing 'New-Object' cmdlet name. The lines should be $certificate = New-Object -TypeName ... and $certificatesRef = New-Object -TypeName ...
| $certificate = -Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSCertificate" | |
| $certificatesRef = -Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSCertificateReferenceNew" -ArgumentList @($certificate) | |
| $certificate = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSCertificate" | |
| $certificatesRef = New-Object -TypeName "Microsoft.Azure.Commands.Batch.Models.PSCertificateReferenceNew" -ArgumentList @($certificate) |
| var1 = $computeNode.Id | ||
| var2 = $computeNode.CertificateReferences | ||
| ``` | ||
|
|
||
| #### After | ||
| ```powershell | ||
| $computeNode = Get-AzBatchComputeNode -PoolId "Pool06" -Id "tvm-2316545714_1-20150725t213220z" -BatchContext $Context | ||
|
|
||
| var1 = $computeNode.Id |
There was a problem hiding this comment.
Missing '$' prefix for variable assignment. Should be $var1 = ... and $var2 = ... to be valid PowerShell syntax.
| var1 = $computeNode.Id | |
| var2 = $computeNode.CertificateReferences | |
| ``` | |
| #### After | |
| ```powershell | |
| $computeNode = Get-AzBatchComputeNode -PoolId "Pool06" -Id "tvm-2316545714_1-20150725t213220z" -BatchContext $Context | |
| var1 = $computeNode.Id | |
| $var1 = $computeNode.Id | |
| $var2 = $computeNode.CertificateReferences |
After
$computeNode = Get-AzBatchComputeNode -PoolId "Pool06" -Id "tvm-2316545714_1-20150725t213220z" -BatchContext $Context
$var1 = $computeNode.Id| var1 = $computeNode.Id | ||
| var2 = $computeNode.CertificateReferences | ||
| ``` | ||
|
|
||
| #### After | ||
| ```powershell | ||
| $computeNode = Get-AzBatchComputeNode -PoolId "Pool06" -Id "tvm-2316545714_1-20150725t213220z" -BatchContext $Context | ||
|
|
||
| var1 = $computeNode.Id |
There was a problem hiding this comment.
Missing '$' prefix for variable assignment. Should be $var1 = ... to be valid PowerShell syntax.
| var1 = $computeNode.Id | |
| var2 = $computeNode.CertificateReferences | |
| ``` | |
| #### After | |
| ```powershell | |
| $computeNode = Get-AzBatchComputeNode -PoolId "Pool06" -Id "tvm-2316545714_1-20150725t213220z" -BatchContext $Context | |
| var1 = $computeNode.Id | |
| $var1 = $computeNode.Id | |
| $var2 = $computeNode.CertificateReferences |
After
$computeNode = Get-AzBatchComputeNode -PoolId "Pool06" -Id "tvm-2316545714_1-20150725t213220z" -BatchContext $Context
$var1 = $computeNode.Id| ### `New-AzOracleAutonomousDatabase` and `Update-AzOracleAutonomousDatabase` | ||
|
|
||
|
|
||
| Cmdlets exposed a parameter named -ScheduledOperations, however he functionality was not implemented. |
There was a problem hiding this comment.
Corrected spelling of 'he' to 'the'.
| Cmdlets exposed a parameter named -ScheduledOperations, however he functionality was not implemented. | |
| Cmdlets exposed a parameter named -ScheduledOperations, however the functionality was not implemented. |
| ### `New-AzBatchCertificate` | ||
|
|
||
| Azure Batch account certificates feature has been retired and all certificate related commands have been removed from Batch. See https://learn.microsoft.com/en-us/azure/batch/batch-certificate-migration-guide | ||
|
|
||
| #### Before |
There was a problem hiding this comment.
The 'After' section is empty for this deprecated cmdlet. Consider adding guidance explaining that there is no direct replacement and pointing users to the Azure Batch certificate migration guide, or explicitly stating 'No replacement available - see migration guide link above for alternatives.'
| ### `Remove-AzBatchCertificate` | ||
|
|
||
| Azure Batch account certificates feature has been retired and all certificate related commands have been removed from Batch. See https://learn.microsoft.com/en-us/azure/batch/batch-certificate-migration-guide | ||
|
|
||
| #### Before |
There was a problem hiding this comment.
The 'After' section is empty. Consider adding guidance explaining that there is no direct replacement and pointing users to the migration guide, or explicitly stating 'No replacement available - see migration guide link above for alternatives.'
| ### `Stop-AzBatchCertificateDeletion` | ||
|
|
||
| Azure Batch account certificates feature has been retired and all certificate related commands have been removed from Batch. See https://learn.microsoft.com/en-us/azure/batch/batch-certificate-migration-guide | ||
|
|
||
| #### Before |
There was a problem hiding this comment.
The 'After' section is empty. Consider adding guidance explaining that there is no direct replacement and pointing users to the migration guide, or explicitly stating 'No replacement available - see migration guide link above for alternatives.'
| ### `Get-AzBatchCertificate` | ||
|
|
||
| Azure Batch account certificates feature has been retired and all certificate related commands have been removed from Batch. See https://learn.microsoft.com/en-us/azure/batch/batch-certificate-migration-guide | ||
|
|
||
| #### Before |
There was a problem hiding this comment.
The 'After' section is empty. Consider adding guidance explaining that there is no direct replacement and pointing users to the migration guide, or explicitly stating 'No replacement available - see migration guide link above for alternatives.'
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Corrected the code block language from 'powerhshell' to 'powershell' in migration guide.
2 participants
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.)
Check this box to confirm: I have read the Submitting Changes section of
CONTRIBUTING.mdand reviewed the following information:ChangeLog.mdfile(s) appropriatelysrc/{{SERVICE}}/{{SERVICE}}/ChangeLog.md.## Upcoming Releaseheader in the past tense.ChangeLog.mdif no new release is required, such as fixing test case only.