Az 16.0.0 移轉指南

Az.DesktopVirtualization

Update-AzWvdApplication

  • 參數的重大變更將影響所有參數集
    • -Tag
      • 參數 ： 「標籤」正在改變。
      • 變更說明：應用程式的更新指令中將移除參數「標籤」。
      • 此變更將於 2026 年 6/2 生效——預計將從 Az 版本「16.0.0」開始生效
      • 預計此變更將於「Az.DesktopVirtualization」版本「6.0.0」生效

之前

Update-AzWvdApplication -ResourceGroupName 'RGName' -GroupName 'AppGroupName' -Name 'AppName' -Tag @{ Env = "Prod" } -FriendlyName 'AppFriendlyName'

之後

Update-AzWvdApplication -ResourceGroupName 'RGName' -GroupName 'AppGroupName' -Name 'AppName' -FriendlyName 'AppFriendlyName'

Update-AzWvdDesktop

  • 參數的重大變更將影響所有參數集
    • -Tag
      • 參數 ： 「標籤」正在改變。
      • 變更說明：參數「Tag」將從桌面版的更新指令中移除。
      • 此變更將於 2026 年 6/2 生效——預計將從 Az 版本「16.0.0」開始生效
      • 預計此變更將於「Az.DesktopVirtualization」版本「6.0.0」生效

之前

Update-AzWvdDesktop -ResourceGroupName 'RGName' -ApplicationGroupName 'AppGroupName' -Name 'DesktopName' -FriendlyName 'DesktopFriendlyName' -Tag @{ Env = "Prod" }

之後

Update-AzWvdDesktop -ResourceGroupName 'RGName' -ApplicationGroupName 'AppGroupName' -Name 'DesktopName' -FriendlyName 'DesktopFriendlyName'

Az.NetworkCloud

Update-AzNetworkCloudVirtualMachine

  • Cmdlet 的重大變更將影響所有參數集——此 Cmdlet 將不再支援 'JsonString' 和 'JsonFilePath' 參數集。 'UpdateViaJsonString' 和 'UpdateViaJsonFilePath' 集合已被移除。 - 指引：更新腳本，使用擴充的參數集，而非傳遞 JSON 輸入。 - 此變更預計將於 2026 年 5 月 1 日生效，分別來自 Az.NetworkCloud 版本：3.0.0 及 Az 版本：16.0.0

之前

$json = @"
{ "location": "eastus", "extendedLocation": { "name": "myCustomLocation", "type": "CustomLocation" }, "tags": { "env": "test" }
}
"@
Update-AzNetworkCloudVirtualMachine ` -ResourceGroupName MyRg ` -Name MyResource ` -JsonString $json

之後

Update-AzNetworkCloudVirtualMachine -ResourceGroupName MyRg -Name MyResource -Location "eastus" -ExtendedLocationName "myCustomLocation" -ExtendedLocationType "CustomLocation" -Tag @{ env = "test" }

Az.PolicyInsights

Get-AzPolicyAttestation

  • Cmdlet 指令的重大變更將影響所有參數集
    • 輸出型別正在從現有的型別 'Microsoft.Azure.Commands.PolicyInsights.Models.Attestations.PSAttestation' 變更為新型別 'Attestation'。
    • 輸出型態中的以下屬性正在被棄用：'SystemData'
    • 以下屬性正在輸出型態中加入：『ResourceGroupName』、『SystemDataCreatedAt』、『SystemDataCreatedBy』、『SystemDataCreatedByType』、『SystemDataLastModifiedAt』、『SystemDataLastModifiedBy』、『SystemDataLastModifiedByType』
    • 此變更預計將從 Az.PolicyInsights 版本 2.0.0 及 Az 版本 16.0.0 生效

之前

$attestation = Get-AzPolicyAttestation -ResourceGroupName "ps-attestation-test-rg" -Name "Attestation-RGScope-Crud"
[Microsoft.Azure.Commands.PolicyInsights.Models.Attestations.PSAttestation]$attestation = $attestation
$creationTime = $attestation.SystemData.CreatedAt

之後

$attestation = Get-AzPolicyAttestation -ResourceGroupName "ps-attestation-test-rg" -Name "Attestation-RGScope-Crud"
[Microsoft.Azure.PowerShell.Cmdlets.PolicyInsights.Models.IAttestation]$attestation = $attestation
$creationTime = $attestation.SystemDataCreatedAt

Get-AzPolicyEvent

  • Cmdlet 指令的重大變更將影響所有參數集
    • 輸出類型 'Microsoft.Azure.指令、政策洞察、模型、政策事件」正在變動
    • 輸出類型中的以下屬性正在被棄用：'ResourceTags' 'ManagementGroupIds'
    • 輸出類型將新增以下屬性：『ResourceTag』、『ManagementGroupId』、『ComplianceState』、『Component』、『EffectiveParameter』、『OdataContext』、『OdataId』、『Keys』、『Values』、『Count』、『AdditionalProperties』
    • 此變更預計將從 Az.PolicyInsights 版本 2.0.0 及 Az 版本 16.0.0 生效

之前

$event = Get-AzPolicyEvent -ResourceGroupName "myResourceGroup" -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"
[Microsoft.Azure.Commands.PolicyInsights.Models.PolicyEvent]$event = $event 
$managementGroup = $event[0].ManagementGroupIds

之後

$event = Get-AzPolicyEvent -ResourceGroupName "myResourceGroup" -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"
[Microsoft.Azure.PowerShell.Cmdlets.PolicyInsights.Models.IPolicyEvent]$event = $event
$managementGroup = $event[0].ManagementGroupId

Get-AzPolicyMetadata

  • Cmdlet 指令的重大變更將影響所有參數集
    • 輸出型別正在從現有型別：'Microsoft.Azure.Commands.PolicyInsights.Models.PSPolicyMetadata' 變更為新型別：'PolicyMetadata'
    • 以下屬性正在輸出類型中加入：「ResourceGroupName」
    • 此變更預計將從 Az.PolicyInsights 版本 2.0.0 及 Az 版本 16.0.0 生效

之前

$metadata = Get-AzPolicyMetadata -Name ACF1348
[Microsoft.Azure.Commands.PolicyInsights.Models.PSPolicyMetadata]$metadata = $metadata

之後

$metadata = Get-AzPolicyMetadata -Name ACF1348
[Microsoft.Azure.PowerShell.Cmdlets.PolicyInsights.Models.PolicyMetadata]$metadata = $metadata

Get-AzPolicyRemediation

  • Cmdlet 指令的重大變更將影響所有參數集
    • 輸出類型正從現有類型 'Microsoft.Azure.Commands.PolicyInsights.Models.Remediation.PSRemediation' 變更為新類型 'Remediation'
    • 輸出類型中的以下屬性正在被棄用：『Filters』、『DeploymentSummary』、『FailureThreshold』、『ParallelDeployments』
    • 以下屬性正在輸出類型中新增：'FilterLocation' 'FilterResourceId' 'DeploymentStatusFailedDeployment' 'DeploymentStatusSuccessfulDeployment' 'DeploymentStatusTotalDeployment' 'FailureThresholdPercentage' 'ParallelDeployment' 'ResourceGroupName' 'SystemDataCreatedAt' 'SystemDataCreatedBy' 'SystemDataCreatedByType' 'SystemDataLastModifiedAt' 'SystemDataLastModifiedBy' 'SystemDataLastModifiedByType'
    • 此變更預計將從 Az.PolicyInsights 版本 2.0.0 及 Az 版本 16.0.0 生效

之前

$remediation = Get-AzPolicyRemediation -ResourceGroupName "myResourceGroup" -Name "remediation1" -IncludeDetail
[Microsoft.Azure.Commands.PolicyInsights.Models.Remediation.PSRemediation]$remediation = $remediation
$locationFilter = $remediation.Filters.Locations

之後

$remediation = Get-AzPolicyRemediation -ResourceGroupName "myResourceGroup" -Name "remediation1" -IncludeDetail
[Microsoft.Azure.PowerShell.Cmdlets.PolicyInsights.Models.IRemediation]$remediation = $remediation
$locationFilter = $remediation.FilterLocation

Get-AzPolicyState

  • Cmdlet 指令的重大變更將影響所有參數集
    • 輸出類型 'Microsoft.Azure.指令、政策洞察、模型、政策狀態」正在變動
    • 輸出類型中的以下屬性正在被棄用：'ResourceTags' 'ManagementGroupIds'
    • 以下屬性正在輸出類型中加入：『ResourceGroupName』、『ResourceTag』、『ManagementGroupId』
    • 此變更預計將從 Az.PolicyInsights 版本 2.0.0 及 Az 版本 16.0.0 生效

之前

$state = Get-AzPolicyState -ResourceGroupName "myResourceGroup" -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"
[Microsoft.Azure.Commands.PolicyInsights.Models.PolicyState]$state = $state
$managementGroup = $state[0].ManagementGroupIds

之後

$state = Get-AzPolicyState -ResourceGroupName "myResourceGroup" -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"
[Microsoft.Azure.PowerShell.Cmdlets.PolicyInsights.Models.IPolicyState]$state = $state
$managementGroup = $state[0].ManagementGroupId

Get-AzPolicyStateSummary

  • Cmdlet 指令的重大變更將影響所有參數集
    • 輸出類型 'Microsoft.Azure.Commands.PolicyInsights.Models.PolicyStateSummary' 正在變更
    • 輸出類型中的以下屬性正在被棄用：『PolicyAssignments』『Results』
    • 輸出類型中新增了以下屬性：『PolicyAssignment』、『ResultCompliantResource』、『ResultNonCompliantPolicy』、『ResultNonCompliantResource』、『ResultPolicyDetail』、『ResultPolicyGroupDetail』、『ResultQueryResultsUri』、『ResultResourceDetail』、『OdataId』、『OdataContext』
    • 此變更預計將從 Az.PolicyInsights 版本 2.0.0 及 Az 版本 16.0.0 生效

之前

$stateSummary = Get-AzPolicyStateSummary -ManagementGroupName "myManagementGroup"
[Microsoft.Azure.Commands.PolicyInsights.Models.PolicyStateSummary]$stateSummary = $stateSummary
$nonCompliantResourceCount = $stateSummary.Results.NonCompliantResources

之後

$stateSummary = Get-AzPolicyStateSummary -ManagementGroupName "myManagementGroup"
[Microsoft.Azure.PowerShell.Cmdlets.PolicyInsights.Models.ISummary]$stateSummary = $stateSummary
$nonCompliantResourceCount = $stateSummary.ResultNonCompliantResource

New-AzPolicyAttestation

  • Cmdlet 指令的重大變更將影響所有參數集
    • 輸出型別正在從現有的型別 'Microsoft.Azure.Commands.PolicyInsights.Models.Attestations.PSAttestation' 變更為新型別 'Attestation'。
    • 輸出型態中的以下屬性正在被棄用：'SystemData'
    • 以下屬性正在輸出型態中加入：『ResourceGroupName』、『SystemDataCreatedAt』、『SystemDataCreatedBy』、『SystemDataCreatedByType』、『SystemDataLastModifiedAt』、『SystemDataLastModifiedBy』、『SystemDataLastModifiedByType』
    • 此變更預計將從 Az.PolicyInsights 版本 2.0.0 及 Az 版本 16.0.0 生效

之前

$attestation = New-AzPolicyAttestation -PolicyAssignmentId $policyAssignmentId -Name $attestationName -ComplianceState "Compliant"
[Microsoft.Azure.Commands.PolicyInsights.Models.Attestations.PSAttestation]$attestation = $attestation
$creationTime = $attestation.SystemData.CreatedAt

之後

$attestation = New-AzPolicyAttestation -PolicyAssignmentId $policyAssignmentId -Name $attestationName -ComplianceState "Compliant"
[Microsoft.Azure.PowerShell.Cmdlets.PolicyInsights.Models.IAttestation]$attestation = $attestation
$creationTime = $attestation.SystemDataCreatedAt

Set-AzPolicyAttestation

  • Cmdlet 指令的重大變更將影響所有參數集
    • 輸出型別正在從現有的型別 'Microsoft.Azure.Commands.PolicyInsights.Models.Attestations.PSAttestation' 變更為新型別 'Attestation'。
    • 輸出型態中的以下屬性正在被棄用：'SystemData'
    • 以下屬性正在輸出型態中加入：『ResourceGroupName』、『SystemDataCreatedAt』、『SystemDataCreatedBy』、『SystemDataCreatedByType』、『SystemDataLastModifiedAt』、『SystemDataLastModifiedBy』、『SystemDataLastModifiedByType』
    • 此變更預計將從 Az.PolicyInsights 版本 2.0.0 及 Az 版本 16.0.0 生效

之前

$attestation = Set-AzPolicyAttestation -PolicyAssignmentId $policyAssignmentId -Name $attestationName -ComplianceState "NonCompliant" -Comment $comment
[Microsoft.Azure.Commands.PolicyInsights.Models.Attestations.PSAttestation]$attestation = $attestation
$creationTime = $attestation.SystemData.CreatedAt

之後

$attestation = Update-AzPolicyAttestation -PolicyAssignmentId $policyAssignmentId -Name $attestationName -ComplianceState "NonCompliant" -Comment $comment
[Microsoft.Azure.PowerShell.Cmdlets.PolicyInsights.Models.IAttestation]$attestation = $attestation
$creationTime = $attestation.SystemDataCreatedAt

Start-AzPolicyRemediation

  • Cmdlet 指令的重大變更將影響所有參數集
    • Start-AzPolicyRemediation 現在會在修復達到終端狀態時返回，除非你使用新的 NoWait 參數。
    • 此變更預計將從 Az.PolicyInsights 版本 2.0.0 及 Az 版本 16.0.0 生效

之前

$remediation = Start-AzPolicyRemediation -PolicyAssignmentId $policyAssignmentId -Name "remediation1"
[Microsoft.Azure.Commands.PolicyInsights.Models.Remediation.PSRemediation]$remediation = $remediation
$locationFilter = $remediation.Filters.Locations

之後

$remediation = Start-AzPolicyRemediation -PolicyAssignmentId $policyAssignmentId -Name "remediation1" -NoWait
[Microsoft.Azure.PowerShell.Cmdlets.PolicyInsights.Models.IRemediation]$remediation = $remediation
$locationFilter = $remediation.FilterLocation

Stop-AzPolicyRemediation

  • Cmdlet 指令的重大變更將影響所有參數集
    • Stop-AzPolicyRemediation 現在會有 NoWait 切換參數，並且會回傳修復物件，而不只是布林值。
    • 此變更預計將從 Az.PolicyInsights 版本 2.0.0 及 Az 版本 16.0.0 生效

之前

$successfulBoolean = Stop-AzPolicyRemediation -ResourceGroupName "myRG" -Name "remediation1"

之後

$remediation = Stop-AzPolicyRemediation -ResourceGroupName "myRG" -Name "remediation1"
[Microsoft.Azure.PowerShell.Cmdlets.PolicyInsights.Models.IRemediation]$remediation = $remediation

Az.Resources

Get-AzPolicyAssignment

此 BackwardCompatible 參數先前是為了保留基於舊有 .Properties的輸出形狀而引入的。 此參數現已移除。 Cmdlet 一律會傳回現代的扁平化物件結構，且已不再支援透過 .Properties.* 的舊版存取方式。 腳本必須更新以直接引用一級屬性。

之前

$policyAssignment = Get-AzPolicyAssignment -Name MyAssignment -BackwardCompatible
$description = $policyAssignment.Properties.Description

之後

$policyAssignment = Get-AzPolicyAssignment -Name MyAssignment
$description = $policyAssignment.Description

Get-AzPolicyDefinition

此 BackwardCompatible 參數先前是為了保留基於舊有 .Properties的輸出形狀而引入的。 此參數現已移除。 Cmdlet 一律會傳回現代的扁平化物件結構，且已不再支援透過 .Properties.* 的舊版存取方式。 腳本必須更新以直接引用一級屬性。

之前

$policyDefinition = Get-AzPolicyDefinition -Builtin -BackwardCompatible | select -First 1
$policyRule = $policyDefinition.Properties.PolicyRule

之後

$policyDefinition = Get-AzPolicyDefinition -Builtin | select -First 1
$policyRule = $policyDefinition.PolicyRule

Get-AzPolicyExemption

此 BackwardCompatible 參數先前是為了保留基於舊有 .Properties的輸出形狀而引入的。 此參數現已移除。 Cmdlet 一律會傳回現代的扁平化物件結構，且已不再支援透過 .Properties.* 的舊版存取方式。 腳本必須更新以直接引用一級屬性。

之前

$policyExemption = Get-AzPolicyExemption -Scope /providers/Microsoft.Management/managementGroups/myManagementGroup -Name MyExemption -BackwardCompatible
$expiresOn = $policyExemption.Properties.ExpiresOn

之後

$policyExemption = Get-AzPolicyExemption -Scope /providers/Microsoft.Management/managementGroups/myManagementGroup -Name MyExemption
$expiresOn = $policyExemption.ExpiresOn

Get-AzPolicySetDefinition

此 BackwardCompatible 參數先前是為了保留基於舊有 .Properties的輸出形狀而引入的。 此參數現已移除。 Cmdlet 一律會傳回現代的扁平化物件結構，且已不再支援透過 .Properties.* 的舊版存取方式。 腳本必須更新以直接引用一級屬性。

之前

$policySetDefinition = Get-AzPolicySetDefinition -Builtin -BackwardCompatible | select -First 1
$policySetParameters = $policySetDefinition.Properties.Parameters

之後

$policySetDefinition = Get-AzPolicySetDefinition -Builtin | select -First 1
$policySetParameters = $policySetDefinition.Parameter

New-AzPolicyAssignment

此 BackwardCompatible 參數先前是為了保留基於舊有 .Properties的輸出形狀而引入的。 此參數現已移除。 Cmdlet 一律會傳回現代的扁平化物件結構，且已不再支援透過 .Properties.* 的舊版存取方式。 腳本必須更新以直接引用一級屬性。

之前

$policyAssignment = New-AzPolicyAssignment -Name MyAssignment -PolicyDefinition MyPolicyDefinition -BackwardCompatible
$enforcementMode = $policyAssignment.Properties.EnforcementMode

之後

$policyAssignment = New-AzPolicyAssignment -Name MyAssignment -PolicyDefinition MyPolicyDefinition
$enforcementMode = $policyAssignment.EnforcementMode

New-AzPolicyDefinition

此 BackwardCompatible 參數先前是為了保留基於舊有 .Properties的輸出形狀而引入的。 此參數現已移除。 Cmdlet 一律會傳回現代的扁平化物件結構，且已不再支援透過 .Properties.* 的舊版存取方式。 腳本必須更新以直接引用一級屬性。

之前

$policyRule = '{ "if": { "field": "type", "like": "Microsoft.DesktopVirtualization/*" }, "then": { "effect": "deny" } }'
$policyDefinition = New-AzPolicyDefinition -Name MyDefinition -Policy $policyRule -BackwardCompatible
$policyType = $policyDefinition.Properties.PolicyType

之後

$policyRule = '{ "if": { "field": "type", "like": "Microsoft.DesktopVirtualization/*" }, "then": { "effect": "deny" } }'
$policyDefinition = New-AzPolicyDefinition -Name MyDefinition -Policy $policyRule
$policyType = $policyDefinition.PolicyType

New-AzPolicyExemption

此 BackwardCompatible 參數先前是為了保留基於舊有 .Properties的輸出形狀而引入的。 此參數現已移除。 Cmdlet 一律會傳回現代的扁平化物件結構，且已不再支援透過 .Properties.* 的舊版存取方式。 腳本必須更新以直接引用一級屬性。

之前

$policyExemption = Get-AzPolicyAssignment -Name MyAssignment | New-AzPolicyExemption -Name MyExemption -ExemptionCategory Mitigated -BackwardCompatible
$policyAssignmentId = $policyExemption.Properties.PolicyAssignmentId

之後

$policyExemption = Get-AzPolicyAssignment -Name MyAssignment | New-AzPolicyExemption -Name MyExemption -ExemptionCategory Mitigated
$policyAssignmentId = $policyExemption.PolicyAssignmentId

New-AzPolicySetDefinition

此 BackwardCompatible 參數先前是為了保留基於舊有 .Properties的輸出形狀而引入的。 此參數現已移除。 Cmdlet 一律會傳回現代的扁平化物件結構，且已不再支援透過 .Properties.* 的舊版存取方式。 腳本必須更新以直接引用一級屬性。

之前

$policyDefinitionReferences = ('[{ "policyDefinitionId": "' + (Get-AzPolicyDefinition -Name MyDefinition).ResourceId + '"}]')
$policySetDefinition = New-AzPolicySetDefinition -Name MySetDefinition -PolicyDefinition $policyDefinitionReferences -BackwardCompatible
$policyDefinitionReferenceId = $policySetDefinition.Properties.PolicyDefinitions[0].policyDefinitionReferenceId

之後

$policyDefinitionReferences = ('[{ "policyDefinitionId": "' + (Get-AzPolicyDefinition -Name MyDefinition).ResourceId + '"}]')
$policySetDefinition = New-AzPolicySetDefinition -Name MySetDefinition -PolicyDefinition $policyDefinitionReferences
$policyDefinitionReferenceId = $policySetDefinition.PolicyDefinition[0].policyDefinitionReferenceId

Remove-AzPolicyAssignment

BackwardCompatible此參數先前是為了保留舊有行為，即 Remove- cmdlet 總是回傳一個值。 此參數現已移除。 Remove- cmdlets 只有在指定 -PassThru 時才會傳回值。

之前

$result = Remove-AzPolicyAssignment -Name MyAssignment -BackwardCompatible

之後

$result = Remove-AzPolicyAssignment -Name MyAssignment -PassThru

Remove-AzPolicyDefinition

BackwardCompatible此參數先前是為了保留舊有行為，即 Remove- cmdlet 總是回傳一個值。 此參數現已移除。 Remove- cmdlets 只有在指定 -PassThru 時才會傳回值。

之前

$result = Remove-AzPolicyDefinition -Name MyDefinition -BackwardCompatible

之後

$result = Remove-AzPolicyDefinition -Name MyDefinition -PassThru

Remove-AzPolicyExemption

BackwardCompatible此參數先前是為了保留舊有行為，即 Remove- cmdlet 總是回傳一個值。 此參數現已移除。 Remove- cmdlets 只有在指定 -PassThru 時才會傳回值。

之前

$result = Remove-AzPolicyExemption -Name MyExemption -BackwardCompatible

之後

$result = Remove-AzPolicyExemption -Name MyExemption -PassThru

Remove-AzPolicySetDefinition

BackwardCompatible此參數先前是為了保留舊有行為，即 Remove- cmdlet 總是回傳一個值。 此參數現已移除。 Remove- cmdlets 只有在指定 -PassThru 時才會傳回值。

之前

$result = Remove-AzPolicySetDefinition -Name MySetDefinition -BackwardCompatible

之後

$result = Remove-AzPolicySetDefinition -Name MySetDefinition -PassThru

Update-AzPolicyAssignment

此 BackwardCompatible 參數先前是為了保留基於舊有 .Properties的輸出形狀而引入的。 此參數現已移除。 Cmdlet 一律會傳回現代的扁平化物件結構，且已不再支援透過 .Properties.* 的舊版存取方式。 腳本必須更新以直接引用一級屬性。

之前

$policyAssignment = Update-AzPolicyAssignment -Name MyAssignment -DisplayName 'My cool assignment' -BackwardCompatible
$displayName = $policyAssignment.Properties.DisplayName

之後

$policyAssignment = Update-AzPolicyAssignment -Name MyAssignment -DisplayName 'My cool assignment'
$displayName = $policyAssignment.DisplayName

Update-AzPolicyDefinition

此 BackwardCompatible 參數先前是為了保留基於舊有 .Properties的輸出形狀而引入的。 此參數現已移除。 Cmdlet 一律會傳回現代的扁平化物件結構，且已不再支援透過 .Properties.* 的舊版存取方式。 腳本必須更新以直接引用一級屬性。

之前

$policyDefinition = Update-AzPolicyDefinition -Name MyDefinition -Description 'A much better policy definition' -BackwardCompatible
$description = $policyDefinition.Properties.Description

之後

$policyDefinition = Update-AzPolicyDefinition -Name MyDefinition -Description 'A much better policy definition'
$description = $policyDefinition.Description

Update-AzPolicyExemption

此 BackwardCompatible 參數先前是為了保留基於舊有 .Properties的輸出形狀而引入的。 此參數現已移除。 Cmdlet 一律會傳回現代的扁平化物件結構，且已不再支援透過 .Properties.* 的舊版存取方式。 腳本必須更新以直接引用一級屬性。

之前

$policyExemption = Update-AzPolicyExemption -Name MyExemption -ExemptionCategory Waiver -BackwardCompatible
$exemptionCategory = $policyExemption.Properties.ExemptionCategory

之後

$policyExemption = Update-AzPolicyExemption -Name MyExemption -ExemptionCategory Waiver
$exemptionCategory = $policyExemption.ExemptionCategory

Update-AzPolicySetDefinition

此 BackwardCompatible 參數先前是為了保留基於舊有 .Properties的輸出形狀而引入的。 此參數現已移除。 Cmdlet 一律會傳回現代的扁平化物件結構，且已不再支援透過 .Properties.* 的舊版存取方式。 腳本必須更新以直接引用一級屬性。

之前

$policySetDefinition = Update-AzPolicySetDefinition -Name MySetDefinition -Metadata '{ "MyThing": "A really good thing" }' -BackwardCompatible
$myThing = $policySetDefinition.Properties.Metadata.MyThing

之後

$policySetDefinition = Update-AzPolicySetDefinition -Name MySetDefinition -Metadata '{ "MyThing": "A really good thing" }'
$myThing = $policySetDefinition.Metadata.MyThing

Az.Sql

New-AzSqlServer

  • 參數重大變更將影響所有參數集 - -EnableSoftDelete - 參數：'EnableSoftDelete' 將變更。 - 變更描述：參數「EnableSoftDelete」將從應用程式的 New-AzSqlServer 指令檔中移除。 - 此變更將於「2026/6/2」生效 - 預計此變更將自 Az 版本「16.0.0」起生效 - 預計此變更將於「Az.Sql」自版本「7.0.0」起生效

之前

New-AzSqlServer -ResourceGroupName $rg -ServerName $server -SqlAdministratorCredentials $sqlCred -Location $location-EnableSoftDelete $true

之後

New-AzSqlServer -ResourceGroupName $rg -ServerName $server -SqlAdministratorCredentials $sqlCred -Location $location -SoftDeleteRetentionDays 7

Set-AzSqlServer

  • 參數重大變更將影響所有參數集 - -EnableSoftDelete - 參數：'EnableSoftDelete' 將變更。 - 變更描述：參數「EnableSoftDelete」將從應用程式的 Set-AzSqlServer 指令檔中移除。 - 此變更將於「2026/6/2」生效 - 預計此變更將自 Az 版本「16.0.0」起生效 - 預計此變更將於「Az.Sql」自版本「7.0.0」起生效

之前

Set-AzSqlServer -ResourceGroupName $rg -ServerName -EnableSoftDelete $true

之後

Set-AzSqlServer -ResourceGroupName $rg -ServerName -SoftDeleteRetentionDays 7

Az.StackHCIVM

New-AzStackHCIVMImage

  • 參數的重大變更將影響所有參數集
    • -ImagePath

之前

ImagePath is of type 'string'

之後

ImagePath has been changed to SecureString

New-AzStackHCIVMVirtualMachine

  • 參數的重大變更將影響所有參數集
    • -AdminPassword

之前

AdminPassword is of type 'string'

之後

AdminPassword has been changed to SecureString

Az.StorageAction

Get-AzStorageActionTask

  • Cmdlet 指令的重大變更將影響所有參數集
    • 輸出類型 'Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IStorageTask' 正在更改
    • 輸出型態中的以下屬性正在被棄用：'IdentityUserAssignedIdentity'
    • 以下屬性正在新增至輸出類型：「IdentityUserAssignedIdentity」
    • 變更說明：屬性「IdentityUserAssignedIdentity」的類型將由「Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IUserAssignedIdentities」更改為「Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IManagedServiceIdentityUserAssignedIdentities」
    • 此變更將於 2026 年 5/1 生效——預計將從 Az 版本 ： '16.0.0' 開始生效
    • 此變更預計將於版本 '2.0.0' 的「Az.StorageAction」中生效

之前

$task = Get-AzStorageActionTask -ResourceGroupName MyRg -Name MyTask
[Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IUserAssignedIdentities]$identity = $task.IdentityUserAssignedIdentity

之後

$task = Get-AzStorageActionTask -ResourceGroupName MyRg -Name MyTask
[Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IManagedServiceIdentityUserAssignedIdentities]$identity = $task.IdentityUserAssignedIdentity

New-AzStorageActionTask

  • Cmdlet 指令的重大變更將影響所有參數集
    • 輸出類型 'Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IStorageTask' 正在更改
    • 輸出型態中的以下屬性正在被棄用：'IdentityUserAssignedIdentity'
    • 以下屬性正在新增至輸出類型：「IdentityUserAssignedIdentity」
    • 變更說明：屬性「IdentityUserAssignedIdentity」的類型將由「Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IUserAssignedIdentities」更改為「Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IManagedServiceIdentityUserAssignedIdentities」
    • 此變更將於 2026 年 5/1 生效——預計將從 Az 版本 ： '16.0.0' 開始生效
    • 此變更預計將於版本 '2.0.0' 的「Az.StorageAction」中生效

之前

$task = New-AzStorageActionTask -ResourceGroupName MyRg -Name MyTask
[Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IUserAssignedIdentities]$identity = $task.IdentityUserAssignedIdentity

之後

$task = New-AzStorageActionTask -ResourceGroupName MyRg -Name MyTask
[Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IManagedServiceIdentityUserAssignedIdentities]$identity = $task.IdentityUserAssignedIdentity

Update-AzStorageActionTask

  • Cmdlet 指令的重大變更將影響所有參數集
    • 輸出類型 'Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IStorageTask' 正在更改
    • 輸出型態中的以下屬性正在被棄用：'IdentityUserAssignedIdentity'
    • 以下屬性正在新增至輸出類型：「IdentityUserAssignedIdentity」
    • 變更說明：屬性「IdentityUserAssignedIdentity」的類型將由「Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IUserAssignedIdentities」更改為「Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IManagedServiceIdentityUserAssignedIdentities」
    • 此變更將於 2026 年 5/1 生效——預計將從 Az 版本 ： '16.0.0' 開始生效
    • 此變更預計將於版本 '2.0.0' 的「Az.StorageAction」中生效

之前

$task = Update-AzStorageActionTask -ResourceGroupName MyRg -Name MyTask
[Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IUserAssignedIdentities]$identity = $task.IdentityUserAssignedIdentity

之後

$task = Update-AzStorageActionTask -ResourceGroupName MyRg -Name MyTask
[Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IManagedServiceIdentityUserAssignedIdentities]$identity = $task.IdentityUserAssignedIdentity

模組從 autorest v3 遷移到 autorest v4

為了維持行為一致性並引入 AutoRest v4 支援的新功能，我們已升級許多模組以支援 AutoRest v4。 此升級引入了多項突破性變更。 關於潛在的破壞性變更及其緩解措施，請參閱以下 連結。

可能受影響的模組

  • Az.CloudService
  • Az.ContainerInstance
  • Az.Databricks
  • Az.DataProtection
  • Azure DNS解析器
  • Az.Functions
  • Az.Kusto
  • Az.LoadTesting
  • Az.MachineLearningServices
  • Az.ManagedServices
  • Az.Migrate
  • Az.Monitor
  • Az.MySql
  • Az.RedisEnterpriseCache
  • Az.ResourceMover
  • Az.SecurityInsights
  • Az.SignalR
  • Az.SqlVirtualMachine
  • Az.StackHCI
  • Az.Websites
  • 上次更新時間：