Skip to content

[Az.Compute] The code base is going to be refactored, the following cmdlet adds a BreakingChange announcement #28315

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 1 commit into
base: main
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
54 changes: 54 additions & 0 deletions src/Compute/Compute.Autorest/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -281,4 +281,58 @@ directive:
parameter-name: SpotPlacementScoresInput
set:
alias: SpotPlacementRecommenderInput

- where:
verb: Get
subject: GalleryApplicationVersion
set:
breaking-change:
deprecated-output-properties:
- PublishingProfileTargetExtendedLocation
- ReplicationStatusSummary
- TargetRegion
new-output-properties:
- PublishingProfileTargetExtendedLocation
- ReplicationStatusSummary
- TargetRegion
change-description: The types of the properties 'PublishingProfileTargetExtendedLocation', 'ReplicationStatusSummary' and 'TargetRegion' will be changed from single object to 'List'.
deprecated-by-version: 9.0.0
deprecated-by-azversion: 15.0.0
change-effective-date: 2025/11/03

- where:
verb: Invoke
subject: SpotPlacementScore
set:
breaking-change:
deprecated-output-properties:
- PlacementScore
- DesiredSize
- DesiredLocation
new-output-properties:
- PlacementScore
- DesiredSize
- DesiredLocation
change-description: The types of the properties 'PlacementScore', 'DesiredSize' and 'DesiredLocation' will be changed from single object to 'List'.
deprecated-by-version: 9.0.0
deprecated-by-azversion: 15.0.0
change-effective-date: 2025/11/03

- where:
verb: Set
subject: VMRunCommand|VmssVMRunCommand
set:
breaking-change:
deprecated-output-properties:
- InstanceViewStatuses
- ProtectedParameter
- Parameter
new-output-properties:
- InstanceViewStatuses
- ProtectedParameter
- Parameter
change-description: The types of the properties 'InstanceViewStatuses', 'ProtectedParameter' and 'Parameter' will be changed from single object to 'List'.
deprecated-by-version: 9.0.0
deprecated-by-azversion: 15.0.0
change-effective-date: 2025/11/03
```
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ Create or update a gallery Application Version.
#>
function New-AzGalleryApplicationVersion {
[OutputType([Microsoft.Azure.PowerShell.Cmdlets.Compute.Models.Api20220103.IGalleryApplicationVersion])]
[Microsoft.Azure.PowerShell.Cmdlets.Compute.Runtime.OutputBreakingChangeAttribute("Microsoft.Azure.PowerShell.Cmdlets.Compute.Models.Api20220103.IGalleryApplicationVersion", "15.0.0", "9.0.0", "2025/11/03", ReplacementCmdletOutputType = "Microsoft.Azure.PowerShell.Cmdlets.Compute.Models.IGalleryApplicationVersion", DeprecatedOutputProperties = ("PublishingProfileTargetExtendedLocation Microsoft.Azure.PowerShell.Cmdlets.Compute.Models.IGalleryTargetExtendedLocation", "ReplicationStatusSummary Microsoft.Azure.PowerShell.Cmdlets.Compute.Models.IRegionalReplicationStatus", "TargetRegion Microsoft.Azure.PowerShell.Cmdlets.Compute.Models.ITargetRegion", "EncryptionDataDiskImage Microsoft.Azure.PowerShell.Cmdlets.Compute.Models.IDataDiskImageEncryption"), NewOutputProperties = ("PublishingProfileTargetExtendedLocation System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.Compute.Models.IGalleryTargetExtendedLocation]", "ReplicationStatusSummary System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.Compute.Models.IRegionalReplicationStatus]", "TargetRegion System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.Compute.Models.ITargetRegion]", "EncryptionDataDiskImage System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.Compute.Models.IDataDiskImageEncryption]"))]
[CmdletBinding(DefaultParameterSetName = 'CreateExpanded', PositionalBinding = $false, SupportsShouldProcess, ConfirmImpact = 'Medium')]
param(
[Parameter(Mandatory)]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@ Update a gallery Application Version.

function Update-AzGalleryApplicationVersion {
[OutputType([Microsoft.Azure.PowerShell.Cmdlets.Compute.Models.Api20220103.IGalleryApplicationVersion])]
[Microsoft.Azure.PowerShell.Cmdlets.Compute.Runtime.OutputBreakingChangeAttribute("Microsoft.Azure.PowerShell.Cmdlets.Compute.Models.Api20220103.IGalleryApplicationVersion", "15.0.0", "9.0.0", "2025/11/03", ReplacementCmdletOutputType = "Microsoft.Azure.PowerShell.Cmdlets.Compute.Models.IGalleryApplicationVersion", DeprecatedOutputProperties = ("PublishingProfileTargetExtendedLocation Microsoft.Azure.PowerShell.Cmdlets.Compute.Models.IGalleryTargetExtendedLocation", "ReplicationStatusSummary Microsoft.Azure.PowerShell.Cmdlets.Compute.Models.IRegionalReplicationStatus", "TargetRegion Microsoft.Azure.PowerShell.Cmdlets.Compute.Models.ITargetRegion"), NewOutputProperties = ("PublishingProfileTargetExtendedLocation System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.Compute.Models.IGalleryTargetExtendedLocation]", "ReplicationStatusSummary System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.Compute.Models.IRegionalReplicationStatus]", "TargetRegion System.Collections.Generic.List`1[Microsoft.Azure.PowerShell.Cmdlets.Compute.Models.ITargetRegion]"))]
[CmdletBinding(DefaultParameterSetName='UpdateExpanded', PositionalBinding=$false, SupportsShouldProcess, ConfirmImpact='Medium')]
param(
[Parameter(ParameterSetName='UpdateExpanded', Mandatory)]
Expand Down
2 changes: 1 addition & 1 deletion src/Compute/Compute.Autorest/docs/Az.Compute.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
Module Name: Az.Compute
Module Guid: 6efa7baa-fa76-4740-bf80-bafbbd1b0b65
Module Guid: 969c43c4-cc53-4871-b660-e3afb5b5796b
Download Help Link: https://learn.microsoft.com/powershell/module/az.compute
Help Version: 1.0.0.0
Locale: en-US
Expand Down
2 changes: 1 addition & 1 deletion src/Compute/Compute.Autorest/generate-info.json
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
{
"generate_Id": "926fc75a-f3b2-4f73-aff1-e949e3a4023d"
"generate_Id": "721e76b4-562a-4c6c-a968-79a86bbb3336"
}
28 changes: 14 additions & 14 deletions src/Compute/Compute.sln
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Az.ManagedServiceIdentity",
EndProject
Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Compute.Autorest", "Compute.Autorest", "{18C4E64E-9E36-9EC3-08A5-34B2FE79BAE7}"
EndProject
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Az.Compute", "..\..\generated\Compute\Compute.Autorest\Az.Compute.csproj", "{D2DD9E1F-9509-4157-8493-F5CFC393FAC3}"
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Az.Compute", "..\..\generated\Compute\Compute.Autorest\Az.Compute.csproj", "{059EADF3-9281-4557-A80B-367109F10C1F}"
EndProject
Global
GlobalSection(SolutionConfigurationPlatforms) = preSolution
Expand Down Expand Up @@ -289,18 +289,18 @@ Global
{443B0412-6B55-4F5B-B6C3-9B26C6F49ECB}.Release|x64.Build.0 = Release|Any CPU
{443B0412-6B55-4F5B-B6C3-9B26C6F49ECB}.Release|x86.ActiveCfg = Release|Any CPU
{443B0412-6B55-4F5B-B6C3-9B26C6F49ECB}.Release|x86.Build.0 = Release|Any CPU
{D2DD9E1F-9509-4157-8493-F5CFC393FAC3}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{D2DD9E1F-9509-4157-8493-F5CFC393FAC3}.Debug|Any CPU.Build.0 = Debug|Any CPU
{D2DD9E1F-9509-4157-8493-F5CFC393FAC3}.Debug|x64.ActiveCfg = Debug|Any CPU
{D2DD9E1F-9509-4157-8493-F5CFC393FAC3}.Debug|x64.Build.0 = Debug|Any CPU
{D2DD9E1F-9509-4157-8493-F5CFC393FAC3}.Debug|x86.ActiveCfg = Debug|Any CPU
{D2DD9E1F-9509-4157-8493-F5CFC393FAC3}.Debug|x86.Build.0 = Debug|Any CPU
{D2DD9E1F-9509-4157-8493-F5CFC393FAC3}.Release|Any CPU.ActiveCfg = Release|Any CPU
{D2DD9E1F-9509-4157-8493-F5CFC393FAC3}.Release|Any CPU.Build.0 = Release|Any CPU
{D2DD9E1F-9509-4157-8493-F5CFC393FAC3}.Release|x64.ActiveCfg = Release|Any CPU
{D2DD9E1F-9509-4157-8493-F5CFC393FAC3}.Release|x64.Build.0 = Release|Any CPU
{D2DD9E1F-9509-4157-8493-F5CFC393FAC3}.Release|x86.ActiveCfg = Release|Any CPU
{D2DD9E1F-9509-4157-8493-F5CFC393FAC3}.Release|x86.Build.0 = Release|Any CPU
{059EADF3-9281-4557-A80B-367109F10C1F}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{059EADF3-9281-4557-A80B-367109F10C1F}.Debug|Any CPU.Build.0 = Debug|Any CPU
{059EADF3-9281-4557-A80B-367109F10C1F}.Debug|x64.ActiveCfg = Debug|Any CPU
{059EADF3-9281-4557-A80B-367109F10C1F}.Debug|x64.Build.0 = Debug|Any CPU
{059EADF3-9281-4557-A80B-367109F10C1F}.Debug|x86.ActiveCfg = Debug|Any CPU
{059EADF3-9281-4557-A80B-367109F10C1F}.Debug|x86.Build.0 = Debug|Any CPU
{059EADF3-9281-4557-A80B-367109F10C1F}.Release|Any CPU.ActiveCfg = Release|Any CPU
{059EADF3-9281-4557-A80B-367109F10C1F}.Release|Any CPU.Build.0 = Release|Any CPU
{059EADF3-9281-4557-A80B-367109F10C1F}.Release|x64.ActiveCfg = Release|Any CPU
{059EADF3-9281-4557-A80B-367109F10C1F}.Release|x64.Build.0 = Release|Any CPU
{059EADF3-9281-4557-A80B-367109F10C1F}.Release|x86.ActiveCfg = Release|Any CPU
{059EADF3-9281-4557-A80B-367109F10C1F}.Release|x86.Build.0 = Release|Any CPU
EndGlobalSection
GlobalSection(SolutionProperties) = preSolution
HideSolutionNode = FALSE
Expand All @@ -320,6 +320,6 @@ Global
{DAD5BF2B-686B-4269-8FFA-5A86D7C23A31} = {6781D587-D8BB-48B9-9952-B05F3D237606}
{F45CEC09-0408-43D6-A679-5149715D9904} = {E9336DDF-EEF7-474E-BCF1-ED87313F4D17}
{2B0B2D44-5207-4192-894E-9AB8DEE6F791} = {6781D587-D8BB-48B9-9952-B05F3D237606}
{D2DD9E1F-9509-4157-8493-F5CFC393FAC3} = {18C4E64E-9E36-9EC3-08A5-34B2FE79BAE7}
{059EADF3-9281-4557-A80B-367109F10C1F} = {18C4E64E-9E36-9EC3-08A5-34B2FE79BAE7}
EndGlobalSection
EndGlobal
2 changes: 1 addition & 1 deletion src/Compute/Compute/Az.Compute.psd1
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
#
# Generated by: Microsoft Corporation
#
# Generated on: 7/24/2025
# Generated on: 2025-07-31
#

@{
Expand Down
9 changes: 9 additions & 0 deletions src/Compute/Compute/ChangeLog.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,15 @@

-->
## Upcoming Release
* Added breaking change announcement for the following cmdlets due to migrating autorest from v3 to v4.
* `Get-GalleryApplicationVersion`
* `New-GalleryApplicationVersion`
* `Update-GalleryApplicationVersion`
* `Invoke-AzSpotPlacementScore`
* `Set-AzVMRunCommand`
* `Set-AzVmssVMRunCommand`

## Version 11.0.0
* Compute DiskRP related cmdlets will now use 2025-01-02 version of the DiskRP API.
* Upgraded SpotPlacementScore cmdlets to api version 2025-06-05

Expand Down
4 changes: 2 additions & 2 deletions src/Compute/Compute/help/Set-AzVMRunCommand.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ The operation to create or update the run command.

### Example 1: Create or update Run Command on a VM using a storage blob SAS URL
```powershell
Set-AzVMRunCommand -ResourceGroupName MyRG0 -VMName MyVMEE -RunCommandName MyRunCommand -Location EastUS2EUAP -SourceScriptUri "https://myst.blob.core.windows.net/mycontainer/myscript.ps1?sp=r&st=2022-10-27T21:02:35Z&se=2022-10-28T05:02:35Z&spr=https&sv=2021-06-08&sr=b&sig=0I%2FIiYayRwHasfasasfdasdfasdeTsQjLnpZjA%3D"
Set-AzVMRunCommand -ResourceGroupName MyRG0 -VMName MyVMEE -RunCommandName MyRunCommand -Location EastUS2EUAP -SourceScriptUri "https://myst.blob.core.windows.net/mycontainer/myscript.ps1?sp=r&st=2022-10-27T21:02:35Z&se=2022-10-28T05:02:35Z&spr=https&sv=2021-06-08&sr=b&sig=******"
```

```output
Expand Down Expand Up @@ -105,7 +105,7 @@ Available commandIds can be retrieved using Get-AzVMRunCommandDocument.

### Example 5: Create or update Run Command on a VM and stream standard output and standard error messages to output and error Append blobs.
```powershell
Set-AzVMRunCommand -ResourceGroupName MyRG0 -VMName MyVML -RunCommandName MyRunCommand3 -Location EastUS2EUAP -ScriptLocalPath "C:\MyScriptsDir\MyScript.ps1" -OutputBlobUri "https://vivst.blob.core.windows.net/vivcontainer/output.txt?sp=racw&st=2022-10-27T22:18:36Z&se=2022-10-28T06:18:36Z&spr=https&sv=2021-06-08&sr=b&sig=HQAu3Bl%2BKMofYTjMo8o5hasfadsfasdF4jIkRJra4S5FlEo%3D" -ErrorBlobUri "https://vivst.blob.core.windows.net/vivcontainer/error.txt?sp=racw&st=2022-10-27T22:18:36Z&se=2022-10-28T06:18:36Z&spr=https&sv=2021-06-08&sr=b&sig=HQAu3Bl%2BKMofYTjMo8o5h%asfasdfgdT%2F4jasfasdf5FlEo%3D"
Set-AzVMRunCommand -ResourceGroupName MyRG0 -VMName MyVML -RunCommandName MyRunCommand3 -Location EastUS2EUAP -ScriptLocalPath "C:\MyScriptsDir\MyScript.ps1" -OutputBlobUri "https://vivst.blob.core.windows.net/vivcontainer/output.txt?sp=racw&st=2022-10-27T22:18:36Z&se=2022-10-28T06:18:36Z&spr=https&sv=2021-06-08&sr=b&sig=******" -ErrorBlobUri "https://vivst.blob.core.windows.net/vivcontainer/error.txt?sp=racw&st=2022-10-27T22:18:36Z&se=2022-10-28T06:18:36Z&spr=https&sv=2021-06-08&sr=b&sig=******"
```

```output
Expand Down
4 changes: 2 additions & 2 deletions src/Compute/Compute/help/Set-AzVmssVMRunCommand.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ The operation to create or update the VMSS VM run command.

### Example 1: Create or update Run Command on a VMSS VM instance using a storage blob SAS URL
```powershell
Set-AzVmssVMRunCommand -ResourceGroupName MyRG0 -VMScaleSetName MyVMSS -InstanceId 0 -RunCommandName MyRunCommand -Location EastUS2EUAP -SourceScriptUri "https://myst.blob.core.windows.net/mycontainer/myscript.ps1?sp=r&st=2022-10-27T21:02:35Z&se=2022-10-28T05:02:35Z&spr=https&sv=2021-06-08&sr=b&sig=0I%2FIiYayRwHasfasasfdasdfasdeTsQjLnpZjA%3D"
Set-AzVmssVMRunCommand -ResourceGroupName MyRG0 -VMScaleSetName MyVMSS -InstanceId 0 -RunCommandName MyRunCommand -Location EastUS2EUAP -SourceScriptUri "https://myst.blob.core.windows.net/mycontainer/myscript.ps1?sp=r&st=2022-10-27T21:02:35Z&se=2022-10-28T05:02:35Z&spr=https&sv=2021-06-08&sr=b&sig=******"
```

```output
Expand Down Expand Up @@ -106,7 +106,7 @@ Available commandIds can be retrieved using Get-AzVMRunCommandDocument.

### Example 5: Create or update Run Command on a VMSS VM instance and stream standard output and standard error messages to output and error Append blobs.
```powershell
Set-AzVmssVMRunCommand -ResourceGroupName MyRG0 -VMScaleSetName MyVMSS -InstanceId 1 -RunCommandName MyRunCommand3 -Location EastUS2EUAP -ScriptLocalPath "C:\MyScriptsDir\MyScript.ps1" -OutputBlobUri "https://vivst.blob.core.windows.net/vivcontainer/output.txt?sp=racw&st=2022-10-27T22:18:36Z&se=2022-10-28T06:18:36Z&spr=https&sv=2021-06-08&sr=b&sig=HQAu3Bl%2BKMofYTjMo8o5hasfadsfasdF4jIkRJra4S5FlEo%3D" -ErrorBlobUri "https://vivst.blob.core.windows.net/vivcontainer/error.txt?sp=racw&st=2022-10-27T22:18:36Z&se=2022-10-28T06:18:36Z&spr=https&sv=2021-06-08&sr=b&sig=HQAu3Bl%2BKMofYTjMo8o5h%asfasdfgdT%2F4jasfasdf5FlEo%3D"
Set-AzVmssVMRunCommand -ResourceGroupName MyRG0 -VMScaleSetName MyVMSS -InstanceId 1 -RunCommandName MyRunCommand3 -Location EastUS2EUAP -ScriptLocalPath "C:\MyScriptsDir\MyScript.ps1" -OutputBlobUri "https://vivst.blob.core.windows.net/vivcontainer/output.txt?sp=racw&st=2022-10-27T22:18:36Z&se=2022-10-28T06:18:36Z&spr=https&sv=2021-06-08&sr=b&sig=******" -ErrorBlobUri "https://vivst.blob.core.windows.net/vivcontainer/error.txt?sp=racw&st=2022-10-27T22:18:36Z&se=2022-10-28T06:18:36Z&spr=https&sv=2021-06-08&sr=b&sig=******"
```

```output
Expand Down