Skip to content

Commit ce5aed0

Browse files
vidai-msftvidai-msft
authored
Updated breaking change message with module name (Azure#22200)
* Updated breaking change message with module name * Sync doc to the upcoming-breaking-changes.md
1 parent 744824b commit ce5aed0

File tree

2 files changed

+190
-30
lines changed

2 files changed

+190
-30
lines changed

‎UpcommingBreakingChange.md‎

Lines changed: 28 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -7,33 +7,33 @@
77
- Parameter breaking-change will happen to all parameter sets
88
- `-DockerBridgeCidr`
99
- DockerBridgeCidr parameter will be deprecated in Az 11.0.0 without being replaced.
10-
- This change is expected to take effect from version: 6.0.0 and Az version: 11.0.0
10+
- This change is expected to take effect from Az.Aks version: 6.0.0 and Az version: 11.0.0
1111

1212
## Az.Compute
1313

1414
### `New-AzDisk`
1515

1616
- Cmdlet breaking-change will happen to all parameter set
1717
- Starting in November 2023 the "New-AzDisk" cmdlet will deploy with the Trusted Launch configuration by default. This includes defaulting the "HyperVGeneration" parameter to "v2". To know more about Trusted Launch, please visit https://learn.microsoft.com/en-us/azure/virtual-machines/trusted-launch
18-
- This change is expected to take effect from version: 7.0.0 and Az version: 11.0.0
18+
- This change is expected to take effect from Az.Compute version: 7.0.0 and Az version: 11.0.0
1919

2020
### `New-AzVM`
2121

2222
- Cmdlet breaking-change will happen to all parameter set
2323
- Consider using the image alias including the version of the distribution you want to use in the "-Image" parameter of the "New-AzVM" cmdlet. On April 30, 2023, the image deployed using `UbuntuLTS` will reach its end of life. In October 2023, the aliases `UbuntuLTS`, `CentOS`, `Debian`, and `RHEL` will be removed.
24-
- This change is expected to take effect from version: 7.0.0 and Az version: 11.0.0
24+
- This change is expected to take effect from Az.Compute version: 7.0.0 and Az version: 11.0.0
2525
- Starting in November 2023 the "New-AzVM" cmdlet will deploy with the Trusted Launch configuration by default. To know more about Trusted Launch, please visit https://docs.microsoft.com/en-us/azure/virtual-machines/trusted-launch
26-
- This change is expected to take effect from version: 7.0.0 and Az version: 11.0.0
26+
- This change is expected to take effect from Az.Compute version: 7.0.0 and Az version: 11.0.0
2727

2828
### `New-AzVmss`
2929

3030
- Cmdlet breaking-change will happen to all parameter set
3131
- Starting November 2023, the "New-AzVmss" cmdlet will default to Trusted Launch VMSS. For more info, visit https://aka.ms/trustedLaunchVMSS.
32-
- This change is expected to take effect from version: 7.0.0 and Az version: 11.0.0
32+
- This change is expected to take effect from Az.Compute version: 7.0.0 and Az version: 11.0.0
3333
- Starting November 2023, the "New-AzVmss" cmdlet will use new defaults: Flexible orchestration mode and enable NATv2 configuration for Load Balancer. To learn more about Flexible Orchestration modes, visit https://aka.ms/orchestrationModeVMSS.
34-
- This change is expected to take effect from version: 7.0.0 and Az version: 11.0.0
34+
- This change is expected to take effect from Az.Compute version: 7.0.0 and Az version: 11.0.0
3535
- Consider using the image alias including the version of the distribution you want to use in the "-ImageName" parameter of the "New-AzVmss" cmdlet. On April 30, 2023, the image deployed using `UbuntuLTS` will reach its end of life. In November 2023, the aliases `UbuntuLTS`, `CentOS`, `Debian`, and `RHEL` will be removed.
36-
- This change is expected to take effect from version: 7.0.0 and Az version: 11.0.0
36+
- This change is expected to take effect from Az.Compute version: 7.0.0 and Az version: 11.0.0
3737

3838
## Az.DesktopVirtualization
3939

@@ -42,45 +42,45 @@
4242
- Parameter breaking-change will happen to all parameter sets
4343
- `-HostPoolType`
4444
- The parameter : 'HostPoolType' is changing.
45-
- The change is expected to take effect from the version : '4.0.0'
45+
- The change is expected to take effect from the Az.DesktopVirtualization version : '4.0.0'
4646

4747
## Az.PowerBIEmbedded
4848

4949
### `Get-AzPowerBIWorkspace`
5050

5151
- Cmdlet breaking-change will happen to all parameter set
5252
- The cmdlet is being deprecated. There will be no replacement for it.
53-
- This change is expected to take effect from version: 2.0.0 and Az version: 11.0.0
53+
- This change is expected to take effect from Az.PowerBIEmbedded version: 2.0.0 and Az version: 11.0.0
5454

5555
### `Get-AzPowerBIWorkspaceCollection`
5656

5757
- Cmdlet breaking-change will happen to all parameter set
5858
- The cmdlet is being deprecated. There will be no replacement for it.
59-
- This change is expected to take effect from version: 2.0.0 and Az version: 11.0.0
59+
- This change is expected to take effect from Az.PowerBIEmbedded version: 2.0.0 and Az version: 11.0.0
6060

6161
### `Get-AzPowerBIWorkspaceCollectionAccessKey`
6262

6363
- Cmdlet breaking-change will happen to all parameter set
6464
- The cmdlet is being deprecated. There will be no replacement for it.
65-
- This change is expected to take effect from version: 2.0.0 and Az version: 11.0.0
65+
- This change is expected to take effect from Az.PowerBIEmbedded version: 2.0.0 and Az version: 11.0.0
6666

6767
### `New-AzPowerBIWorkspaceCollection`
6868

6969
- Cmdlet breaking-change will happen to all parameter set
7070
- The cmdlet is being deprecated. There will be no replacement for it.
71-
- This change is expected to take effect from version: 2.0.0 and Az version: 11.0.0
71+
- This change is expected to take effect from Az.PowerBIEmbedded version: 2.0.0 and Az version: 11.0.0
7272

7373
### `Remove-AzPowerBIWorkspaceCollection`
7474

7575
- Cmdlet breaking-change will happen to all parameter set
7676
- The cmdlet is being deprecated. There will be no replacement for it.
77-
- This change is expected to take effect from version: 2.0.0 and Az version: 11.0.0
77+
- This change is expected to take effect from Az.PowerBIEmbedded version: 2.0.0 and Az version: 11.0.0
7878

7979
### `Reset-AzPowerBIWorkspaceCollectionAccessKey`
8080

8181
- Cmdlet breaking-change will happen to all parameter set
8282
- The cmdlet is being deprecated. There will be no replacement for it.
83-
- This change is expected to take effect from version: 2.0.0 and Az version: 11.0.0
83+
- This change is expected to take effect from Az.PowerBIEmbedded version: 2.0.0 and Az version: 11.0.0
8484

8585
## Az.RecoveryServices
8686

@@ -89,77 +89,76 @@
8989
- Parameter breaking-change will happen to all parameter sets
9090
- `-Certificate`
9191
- Parameter is being deprecated without being replaced
92-
- This change is expected to take effect from version: 7.0.0 and Az version: 11.0.0
92+
- This change is expected to take effect from Az.RecoveryServices version: 7.0.0 and Az version: 11.0.0
9393

9494
## Az.Storage
9595

9696
### `New-AzDataLakeGen2SasToken`
9797

9898
- Cmdlet breaking-change will happen to all parameter set
9999
- The leading question mark '?' of the created SAS token will be removed in a future release.
100-
- This change is expected to take effect from version: 6.0.0 and Az version: 11.0.0
100+
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0
101101

102102
### `New-AzStorageAccount`
103103

104104
- Cmdlet breaking-change will happen to all parameter set
105-
- Default value of AllowBlobPublicAccess and AllowCrossTenantReplication will be changed from True to False in a future release.
106-
When AllowBlobPublicAccess is False on a storage account, it is not permitted to configure container ACLs to allow anonymous access to blobs within the storage account.
105+
- Default value of AllowBlobPublicAccess and AllowCrossTenantReplication will be changed from True to False in a future release.
106+
When AllowBlobPublicAccess is False on a storage account, it is not permitted to configure container ACLs to allow anonymous access to blobs within the storage account.
107107
When AllowCrossTenantReplication is False on a storage account, cross AAD tenant object replication is not allowed.
108-
- This change is expected to take effect from version: 6.0.0 and Az version: 11.0.0
108+
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0
109109

110110
### `New-AzStorageAccountSASToken`
111111

112112
- Cmdlet breaking-change will happen to all parameter set
113113
- The leading question mark '?' of the created SAS token will be removed in a future release.
114-
- This change is expected to take effect from version: 6.0.0 and Az version: 11.0.0
114+
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0
115115

116116
### `New-AzStorageBlobSASToken`
117117

118118
- Cmdlet breaking-change will happen to all parameter set
119119
- The leading question mark '?' of the created SAS token will be removed in a future release.
120-
- This change is expected to take effect from version: 6.0.0 and Az version: 11.0.0
120+
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0
121121

122122
### `New-AzStorageContainerSASToken`
123123

124124
- Cmdlet breaking-change will happen to all parameter set
125125
- The leading question mark '?' of the created SAS token will be removed in a future release.
126-
- This change is expected to take effect from version: 6.0.0 and Az version: 11.0.0
126+
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0
127127

128128
### `New-AzStorageContext`
129129

130130
- Parameter breaking-change will happen to all parameter sets
131131
- `-SasToken`
132132
- The SAS token in created Storage context properties 'ConnectionString' and 'StorageAccount.Credentials' won't have the leading question mark '?' in a future release.
133-
- This change is expected to take effect from version: 6.0.0 and Az version: 11.0.0
133+
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0
134134

135135
### `New-AzStorageFileSASToken`
136136

137137
- Cmdlet breaking-change will happen to all parameter set
138138
- The leading question mark '?' of the created SAS token will be removed in a future release.
139-
- This change is expected to take effect from version: 6.0.0 and Az version: 11.0.0
139+
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0
140140

141141
### `New-AzStorageQueueSASToken`
142142

143143
- Cmdlet breaking-change will happen to all parameter set
144144
- The leading question mark '?' of the created SAS token will be removed in a future release.
145-
- This change is expected to take effect from version: 6.0.0 and Az version: 11.0.0
145+
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0
146146

147147
### `New-AzStorageShareSASToken`
148148

149149
- Cmdlet breaking-change will happen to all parameter set
150150
- The leading question mark '?' of the created SAS token will be removed in a future release.
151-
- This change is expected to take effect from version: 6.0.0 and Az version: 11.0.0
151+
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0
152152

153153
### `New-AzStorageTableSASToken`
154154

155155
- Cmdlet breaking-change will happen to all parameter set
156156
- The leading question mark '?' of the created SAS token will be removed in a future release.
157-
- This change is expected to take effect from version: 6.0.0 and Az version: 11.0.0
157+
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0
158158

159159
### `Set-AzStorageAccount`
160160

161161
- Parameter breaking-change will happen to all parameter sets
162162
- `-EnableLargeFileShare`
163163
- EnableLargeFileShare parameter will be deprecated in a future release.
164-
- This change is expected to take effect from version: 6.0.0 and Az version: 11.0.0
165-
164+
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0

‎documentation/breaking-changes/upcoming-breaking-changes.md‎

Lines changed: 162 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,164 @@
11
# Upcoming breaking changes in Azure PowerShell
22

3-
There is currently no planned breaking change for the next major release of Azure PowerShell - Az 11.
3+
## Az.Aks
4+
5+
### `New-AzAksCluster`
6+
7+
- Parameter breaking-change will happen to all parameter sets
8+
- `-DockerBridgeCidr`
9+
- DockerBridgeCidr parameter will be deprecated in Az 11.0.0 without being replaced.
10+
- This change is expected to take effect from Az.Aks version: 6.0.0 and Az version: 11.0.0
11+
12+
## Az.Compute
13+
14+
### `New-AzDisk`
15+
16+
- Cmdlet breaking-change will happen to all parameter set
17+
- Starting in November 2023 the "New-AzDisk" cmdlet will deploy with the Trusted Launch configuration by default. This includes defaulting the "HyperVGeneration" parameter to "v2". To know more about Trusted Launch, please visit https://learn.microsoft.com/en-us/azure/virtual-machines/trusted-launch
18+
- This change is expected to take effect from Az.Compute version: 7.0.0 and Az version: 11.0.0
19+
20+
### `New-AzVM`
21+
22+
- Cmdlet breaking-change will happen to all parameter set
23+
- Consider using the image alias including the version of the distribution you want to use in the "-Image" parameter of the "New-AzVM" cmdlet. On April 30, 2023, the image deployed using `UbuntuLTS` will reach its end of life. In October 2023, the aliases `UbuntuLTS`, `CentOS`, `Debian`, and `RHEL` will be removed.
24+
- This change is expected to take effect from Az.Compute version: 7.0.0 and Az version: 11.0.0
25+
- Starting in November 2023 the "New-AzVM" cmdlet will deploy with the Trusted Launch configuration by default. To know more about Trusted Launch, please visit https://docs.microsoft.com/en-us/azure/virtual-machines/trusted-launch
26+
- This change is expected to take effect from Az.Compute version: 7.0.0 and Az version: 11.0.0
27+
28+
### `New-AzVmss`
29+
30+
- Cmdlet breaking-change will happen to all parameter set
31+
- Starting November 2023, the "New-AzVmss" cmdlet will default to Trusted Launch VMSS. For more info, visit https://aka.ms/trustedLaunchVMSS.
32+
- This change is expected to take effect from Az.Compute version: 7.0.0 and Az version: 11.0.0
33+
- Starting November 2023, the "New-AzVmss" cmdlet will use new defaults: Flexible orchestration mode and enable NATv2 configuration for Load Balancer. To learn more about Flexible Orchestration modes, visit https://aka.ms/orchestrationModeVMSS.
34+
- This change is expected to take effect from Az.Compute version: 7.0.0 and Az version: 11.0.0
35+
- Consider using the image alias including the version of the distribution you want to use in the "-ImageName" parameter of the "New-AzVmss" cmdlet. On April 30, 2023, the image deployed using `UbuntuLTS` will reach its end of life. In November 2023, the aliases `UbuntuLTS`, `CentOS`, `Debian`, and `RHEL` will be removed.
36+
- This change is expected to take effect from Az.Compute version: 7.0.0 and Az version: 11.0.0
37+
38+
## Az.DesktopVirtualization
39+
40+
### `New-AzWvdScalingPlan`
41+
42+
- Parameter breaking-change will happen to all parameter sets
43+
- `-HostPoolType`
44+
- The parameter : 'HostPoolType' is changing.
45+
- The change is expected to take effect from the Az.DesktopVirtualization version : '4.0.0'
46+
47+
## Az.PowerBIEmbedded
48+
49+
### `Get-AzPowerBIWorkspace`
50+
51+
- Cmdlet breaking-change will happen to all parameter set
52+
- The cmdlet is being deprecated. There will be no replacement for it.
53+
- This change is expected to take effect from Az.PowerBIEmbedded version: 2.0.0 and Az version: 11.0.0
54+
55+
### `Get-AzPowerBIWorkspaceCollection`
56+
57+
- Cmdlet breaking-change will happen to all parameter set
58+
- The cmdlet is being deprecated. There will be no replacement for it.
59+
- This change is expected to take effect from Az.PowerBIEmbedded version: 2.0.0 and Az version: 11.0.0
60+
61+
### `Get-AzPowerBIWorkspaceCollectionAccessKey`
62+
63+
- Cmdlet breaking-change will happen to all parameter set
64+
- The cmdlet is being deprecated. There will be no replacement for it.
65+
- This change is expected to take effect from Az.PowerBIEmbedded version: 2.0.0 and Az version: 11.0.0
66+
67+
### `New-AzPowerBIWorkspaceCollection`
68+
69+
- Cmdlet breaking-change will happen to all parameter set
70+
- The cmdlet is being deprecated. There will be no replacement for it.
71+
- This change is expected to take effect from Az.PowerBIEmbedded version: 2.0.0 and Az version: 11.0.0
72+
73+
### `Remove-AzPowerBIWorkspaceCollection`
74+
75+
- Cmdlet breaking-change will happen to all parameter set
76+
- The cmdlet is being deprecated. There will be no replacement for it.
77+
- This change is expected to take effect from Az.PowerBIEmbedded version: 2.0.0 and Az version: 11.0.0
78+
79+
### `Reset-AzPowerBIWorkspaceCollectionAccessKey`
80+
81+
- Cmdlet breaking-change will happen to all parameter set
82+
- The cmdlet is being deprecated. There will be no replacement for it.
83+
- This change is expected to take effect from Az.PowerBIEmbedded version: 2.0.0 and Az version: 11.0.0
84+
85+
## Az.RecoveryServices
86+
87+
### `Get-AzRecoveryServicesVaultSettingsFile`
88+
89+
- Parameter breaking-change will happen to all parameter sets
90+
- `-Certificate`
91+
- Parameter is being deprecated without being replaced
92+
- This change is expected to take effect from Az.RecoveryServices version: 7.0.0 and Az version: 11.0.0
93+
94+
## Az.Storage
95+
96+
### `New-AzDataLakeGen2SasToken`
97+
98+
- Cmdlet breaking-change will happen to all parameter set
99+
- The leading question mark '?' of the created SAS token will be removed in a future release.
100+
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0
101+
102+
### `New-AzStorageAccount`
103+
104+
- Cmdlet breaking-change will happen to all parameter set
105+
- Default value of AllowBlobPublicAccess and AllowCrossTenantReplication will be changed from True to False in a future release.
106+
When AllowBlobPublicAccess is False on a storage account, it is not permitted to configure container ACLs to allow anonymous access to blobs within the storage account.
107+
When AllowCrossTenantReplication is False on a storage account, cross AAD tenant object replication is not allowed.
108+
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0
109+
110+
### `New-AzStorageAccountSASToken`
111+
112+
- Cmdlet breaking-change will happen to all parameter set
113+
- The leading question mark '?' of the created SAS token will be removed in a future release.
114+
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0
115+
116+
### `New-AzStorageBlobSASToken`
117+
118+
- Cmdlet breaking-change will happen to all parameter set
119+
- The leading question mark '?' of the created SAS token will be removed in a future release.
120+
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0
121+
122+
### `New-AzStorageContainerSASToken`
123+
124+
- Cmdlet breaking-change will happen to all parameter set
125+
- The leading question mark '?' of the created SAS token will be removed in a future release.
126+
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0
127+
128+
### `New-AzStorageContext`
129+
130+
- Parameter breaking-change will happen to all parameter sets
131+
- `-SasToken`
132+
- The SAS token in created Storage context properties 'ConnectionString' and 'StorageAccount.Credentials' won't have the leading question mark '?' in a future release.
133+
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0
134+
135+
### `New-AzStorageFileSASToken`
136+
137+
- Cmdlet breaking-change will happen to all parameter set
138+
- The leading question mark '?' of the created SAS token will be removed in a future release.
139+
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0
140+
141+
### `New-AzStorageQueueSASToken`
142+
143+
- Cmdlet breaking-change will happen to all parameter set
144+
- The leading question mark '?' of the created SAS token will be removed in a future release.
145+
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0
146+
147+
### `New-AzStorageShareSASToken`
148+
149+
- Cmdlet breaking-change will happen to all parameter set
150+
- The leading question mark '?' of the created SAS token will be removed in a future release.
151+
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0
152+
153+
### `New-AzStorageTableSASToken`
154+
155+
- Cmdlet breaking-change will happen to all parameter set
156+
- The leading question mark '?' of the created SAS token will be removed in a future release.
157+
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0
158+
159+
### `Set-AzStorageAccount`
160+
161+
- Parameter breaking-change will happen to all parameter sets
162+
- `-EnableLargeFileShare`
163+
- EnableLargeFileShare parameter will be deprecated in a future release.
164+
- This change is expected to take effect from Az.Storage version: 6.0.0 and Az version: 11.0.0

0 commit comments

Comments
 (0)