Migrationshandbuch für Az 16.0.0

Az.DesktopVirtualization

Update-AzWvdApplication

  • Parameterumbruchänderungen werden für alle Parametersätze vorgenommen.
    • -Tag
      • Der Parameter : 'Tag' wird geändert.
      • Beschreibung ändern: Der Parameter "Tag" wird aus dem Update-Cmdlet der Anwendung entfernt.
      • Diese Änderung wird am 02.06.2026 wirksam. Es wird erwartet, dass die Änderung ab Az-Version '16.0.0' wirksam wird.
      • Die Änderung wird voraussichtlich in "Az.DesktopVirtualization" ab Version '6.0.0' wirksam werden.

Vorher

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

Nach

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

Update-AzWvdDesktop

  • Parameterumbruchänderungen werden für alle Parametersätze vorgenommen.
    • -Tag
      • Der Parameter : 'Tag' wird geändert.
      • Beschreibung ändern: Der Parameter "Tag" wird aus dem Update-Cmdlet von Desktop entfernt.
      • Diese Änderung wird am 02.06.2026 wirksam. Es wird erwartet, dass die Änderung ab Az-Version '16.0.0' wirksam wird.
      • Die Änderung wird voraussichtlich in "Az.DesktopVirtualization" ab Version '6.0.0' wirksam werden.

Vorher

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

Nach

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

Az.NetworkCloud

Update-AzNetworkCloudVirtualMachine

  • Die Breaking Change des Cmdlets betrifft alle Parametersätze – das Cmdlet unterstützt die Parametersätze 'JsonString' und 'JsonFilePath' nicht länger. Die Sets "UpdateViaJsonString" und "UpdateViaJsonFilePath" wurden entfernt. - Anleitung: Aktualisieren sie Skripts, um die erweiterten Parametersätze zu verwenden, anstatt JSON-Eingaben zu übergeben. - Diese Änderung wird voraussichtlich am 1.5.2026 wirksam, ab Az.NetworkCloud-Version 3.0.0 und Az-Version 16.0.0.

Vorher

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

Nach

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

Az.PolicyInsights

Get-AzPolicyAttestation

  • Cmdlet-Breaking-Change betrifft alle Parametersätze
    • Der Ausgabetyp wird vom bestehenden Typ :'Microsoft.Azure.Commands.PolicyInsights.Models.Attestations.PSAttestation' zum neuen Typ :'Attestation' geändert.
    • Die folgenden Eigenschaften im Ausgabetyp sind veraltet: 'SystemData'
    • Die folgenden Eigenschaften werden dem Ausgabetyp hinzugefügt: 'ResourceGroupName', 'SystemDataCreatedAt', 'SystemDataCreatedBy', 'SystemDataCreatedByType', 'SystemDataLastModifiedAt', 'SystemDataLastModifiedBy', 'SystemDataLastModifiedByType'
    • Diese Änderung wird voraussichtlich ab Version Az.PolicyInsights: 2.0.0 und Az: 16.0.0 wirksam.

Vorher

$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

Nach

$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-Breaking-Change betrifft alle Parametersätze
    • Der Ausgabetyp 'Microsoft.Azure. Commands.PolicyInsights.Models.PolicyEvent' ändert sich
    • Die folgenden Eigenschaften im Ausgabetyp sind veraltet: 'ResourceTags' 'ManagementGroupIds'
    • Die folgenden Eigenschaften werden dem Ausgabetyp hinzugefügt: 'ResourceTag' 'ManagementGroupId' 'ComplianceState' 'Component' 'EffectiveParameter' 'OdataContext' 'OdataId' 'Keys' 'Values' 'Count' 'AdditionalProperties'
    • Diese Änderung wird voraussichtlich ab Version Az.PolicyInsights: 2.0.0 und Az: 16.0.0 wirksam.

Vorher

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

Nach

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

Get-AzPolicyMetadata

  • Cmdlet-Breaking-Change betrifft alle Parametersätze
    • Der Ausgabetyp ändert sich vom vorhandenen Typ 'Microsoft.Azure.Commands.PolicyInsights.Models.PSPolicyMetadata' zum neuen Typ 'PolicyMetadata'.
    • Die folgenden Eigenschaften werden dem Ausgabetyp hinzugefügt: 'ResourceGroupName'
    • Diese Änderung wird voraussichtlich ab Version Az.PolicyInsights: 2.0.0 und Az: 16.0.0 wirksam.

Vorher

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

Nach

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

Get-AzPolicyRemediation

  • Cmdlet-Breaking-Change betrifft alle Parametersätze
    • Der Ausgabetyp ändert sich vom vorhandenen Typ 'Microsoft.Azure.Commands.PolicyInsights.Models.Remediation.PSRemediation' zum neuen Typ 'Remediation'.
    • Die folgenden Eigenschaften im Ausgabetyp sind veraltet: 'Filters', 'DeploymentSummary', 'FailureThreshold', 'ParallelDeployments'
    • Dem Ausgabetyp werden die folgenden Eigenschaften hinzugefügt: 'FilterLocation', 'FilterResourceId', 'DeploymentStatusFailedDeployment', 'DeploymentStatusSuccessfulDeployment', 'DeploymentStatusTotalDeployment', 'FailureThresholdPercentage', 'ParallelDeployment', 'ResourceGroupName', 'SystemDataCreatedAt', 'SystemDataCreatedBy', 'SystemDataCreatedByType', 'SystemDataLastModifiedAt', 'SystemDataLastModifiedBy', 'SystemDataLastModifiedByType'.
    • Diese Änderung wird voraussichtlich ab Version Az.PolicyInsights: 2.0.0 und Az: 16.0.0 wirksam.

Vorher

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

Nach

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

Get-AzPolicyState

  • Cmdlet-Breaking-Change betrifft alle Parametersätze
    • Der Ausgabetyp 'Microsoft.Azure. Commands.PolicyInsights.Models.PolicyState' ändert sich
    • Die folgenden Eigenschaften im Ausgabetyp sind veraltet: 'ResourceTags' 'ManagementGroupIds'
    • Die folgenden Eigenschaften werden dem Ausgabetyp hinzugefügt: 'ResourceGroupName' 'ResourceTag' 'ManagementGroupId'
    • Diese Änderung wird voraussichtlich ab Version Az.PolicyInsights: 2.0.0 und Az: 16.0.0 wirksam.

Vorher

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

Nach

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

Get-AzPolicyStateSummary

  • Cmdlet-Breaking-Change betrifft alle Parametersätze
    • Der Ausgabetyp 'Microsoft.Azure. Commands.PolicyInsights.Models.PolicyStateSummary' ändert sich
    • Die folgenden Eigenschaften im Ausgabetyp werden abgekündigt: 'PolicyAssignments' und 'Results'
    • Die folgenden Eigenschaften werden dem Ausgabetyp hinzugefügt: 'PolicyAssignment', 'ResultCompliantResource', 'ResultNonCompliantPolicy', 'ResultNonCompliantResource', 'ResultPolicyDetail', 'ResultPolicyGroupDetail', 'ResultQueryResultsUri', 'ResultResourceDetail', 'OdataId', 'OdataContext'
    • Diese Änderung wird voraussichtlich ab Version Az.PolicyInsights: 2.0.0 und Az: 16.0.0 wirksam.

Vorher

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

Nach

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

New-AzPolicyAttestation

  • Cmdlet-Breaking-Change betrifft alle Parametersätze
    • Der Ausgabetyp wird vom bestehenden Typ :'Microsoft.Azure.Commands.PolicyInsights.Models.Attestations.PSAttestation' zum neuen Typ :'Attestation' geändert.
    • Die folgenden Eigenschaften im Ausgabetyp sind veraltet: 'SystemData'
    • Die folgenden Eigenschaften werden dem Ausgabetyp hinzugefügt: 'ResourceGroupName', 'SystemDataCreatedAt', 'SystemDataCreatedBy', 'SystemDataCreatedByType', 'SystemDataLastModifiedAt', 'SystemDataLastModifiedBy', 'SystemDataLastModifiedByType'
    • Diese Änderung wird voraussichtlich ab Version Az.PolicyInsights: 2.0.0 und Az: 16.0.0 wirksam.

Vorher

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

Nach

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

Set-AzPolicyAttestation

  • Cmdlet-Breaking-Change betrifft alle Parametersätze
    • Der Ausgabetyp wird vom bestehenden Typ :'Microsoft.Azure.Commands.PolicyInsights.Models.Attestations.PSAttestation' zum neuen Typ :'Attestation' geändert.
    • Die folgenden Eigenschaften im Ausgabetyp sind veraltet: 'SystemData'
    • Die folgenden Eigenschaften werden dem Ausgabetyp hinzugefügt: 'ResourceGroupName', 'SystemDataCreatedAt', 'SystemDataCreatedBy', 'SystemDataCreatedByType', 'SystemDataLastModifiedAt', 'SystemDataLastModifiedBy', 'SystemDataLastModifiedByType'
    • Diese Änderung wird voraussichtlich ab Version Az.PolicyInsights: 2.0.0 und Az: 16.0.0 wirksam.

Vorher

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

Nach

$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-Breaking-Change betrifft alle Parametersätze
    • Start-AzPolicyRemediation wird nun zurückgegeben, wenn die Wartung einen Terminalzustand erreicht, es sei denn, Sie verwenden den neuen NoWait-Parameter.
    • Diese Änderung wird voraussichtlich ab Version Az.PolicyInsights: 2.0.0 und Az: 16.0.0 wirksam.

Vorher

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

Nach

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

Stop-AzPolicyRemediation

  • Cmdlet-Breaking-Change betrifft alle Parametersätze
    • Stop-AzPolicyRemediation verfügt jetzt über einen NoWait-Switchparameter und gibt das Remediation-Objekt zurück, anstatt nur einen booleschen Wert.
    • Diese Änderung wird voraussichtlich ab Version Az.PolicyInsights: 2.0.0 und Az: 16.0.0 wirksam.

Vorher

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

Nach

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

Az.Resources

Get-AzPolicyAssignment

Der BackwardCompatibleParameter wurde zuvor eingeführt, um die auf .Properties-basierende Legacy-Ausgabeform beizubehalten. Dieser Parameter wurde jetzt entfernt. Cmdlets geben immer die moderne abgeflachte Objektstruktur zurück, und der Legacyzugriff über .Properties.* wird nicht mehr unterstützt. Skripts müssen aktualisiert werden, um direkt auf Erstklassige Eigenschaften zu verweisen.

Vorher

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

Nach

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

Get-AzPolicyDefinition

Der BackwardCompatibleParameter wurde zuvor eingeführt, um die auf .Properties-basierende Legacy-Ausgabeform beizubehalten. Dieser Parameter wurde jetzt entfernt. Cmdlets geben immer die moderne abgeflachte Objektstruktur zurück, und der Legacyzugriff über .Properties.* wird nicht mehr unterstützt. Skripts müssen aktualisiert werden, um direkt auf Erstklassige Eigenschaften zu verweisen.

Vorher

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

Nach

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

Get-AzPolicyExemption

Der BackwardCompatibleParameter wurde zuvor eingeführt, um die auf .Properties-basierende Legacy-Ausgabeform beizubehalten. Dieser Parameter wurde jetzt entfernt. Cmdlets geben immer die moderne abgeflachte Objektstruktur zurück, und der Legacyzugriff über .Properties.* wird nicht mehr unterstützt. Skripts müssen aktualisiert werden, um direkt auf Erstklassige Eigenschaften zu verweisen.

Vorher

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

Nach

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

Get-AzPolicySetDefinition

Der BackwardCompatibleParameter wurde zuvor eingeführt, um die auf .Properties-basierende Legacy-Ausgabeform beizubehalten. Dieser Parameter wurde jetzt entfernt. Cmdlets geben immer die moderne abgeflachte Objektstruktur zurück, und der Legacyzugriff über .Properties.* wird nicht mehr unterstützt. Skripts müssen aktualisiert werden, um direkt auf Erstklassige Eigenschaften zu verweisen.

Vorher

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

Nach

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

New-AzPolicyAssignment

Der BackwardCompatibleParameter wurde zuvor eingeführt, um die auf .Properties-basierende Legacy-Ausgabeform beizubehalten. Dieser Parameter wurde jetzt entfernt. Cmdlets geben immer die moderne abgeflachte Objektstruktur zurück, und der Legacyzugriff über .Properties.* wird nicht mehr unterstützt. Skripts müssen aktualisiert werden, um direkt auf Erstklassige Eigenschaften zu verweisen.

Vorher

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

Nach

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

New-AzPolicyDefinition

Der BackwardCompatibleParameter wurde zuvor eingeführt, um die auf .Properties-basierende Legacy-Ausgabeform beizubehalten. Dieser Parameter wurde jetzt entfernt. Cmdlets geben immer die moderne abgeflachte Objektstruktur zurück, und der Legacyzugriff über .Properties.* wird nicht mehr unterstützt. Skripts müssen aktualisiert werden, um direkt auf Erstklassige Eigenschaften zu verweisen.

Vorher

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

Nach

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

New-AzPolicyExemption

Der BackwardCompatibleParameter wurde zuvor eingeführt, um die auf .Properties-basierende Legacy-Ausgabeform beizubehalten. Dieser Parameter wurde jetzt entfernt. Cmdlets geben immer die moderne abgeflachte Objektstruktur zurück, und der Legacyzugriff über .Properties.* wird nicht mehr unterstützt. Skripts müssen aktualisiert werden, um direkt auf Erstklassige Eigenschaften zu verweisen.

Vorher

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

Nach

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

New-AzPolicySetDefinition

Der BackwardCompatibleParameter wurde zuvor eingeführt, um die auf .Properties-basierende Legacy-Ausgabeform beizubehalten. Dieser Parameter wurde jetzt entfernt. Cmdlets geben immer die moderne abgeflachte Objektstruktur zurück, und der Legacyzugriff über .Properties.* wird nicht mehr unterstützt. Skripts müssen aktualisiert werden, um direkt auf Erstklassige Eigenschaften zu verweisen.

Vorher

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

Nach

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

Remove-AzPolicyAssignment

Der BackwardCompatible Parameter wurde zuvor eingeführt, um das Legacyverhalten beizubehalten, bei dem Remove- Cmdlets immer einen Wert zurückgegeben haben. Dieser Parameter wurde jetzt entfernt. Remove- Cmdlets geben nur einen Wert zurück, wenn -PassThru angegeben wird.

Vorher

$result = Remove-AzPolicyAssignment -Name MyAssignment -BackwardCompatible

Nach

$result = Remove-AzPolicyAssignment -Name MyAssignment -PassThru

Remove-AzPolicyDefinition

Der BackwardCompatible Parameter wurde zuvor eingeführt, um das Legacyverhalten beizubehalten, bei dem Remove- Cmdlets immer einen Wert zurückgegeben haben. Dieser Parameter wurde jetzt entfernt. Remove- Cmdlets geben nur einen Wert zurück, wenn -PassThru angegeben wird.

Vorher

$result = Remove-AzPolicyDefinition -Name MyDefinition -BackwardCompatible

Nach

$result = Remove-AzPolicyDefinition -Name MyDefinition -PassThru

Remove-AzPolicyExemption

Der BackwardCompatible Parameter wurde zuvor eingeführt, um das Legacyverhalten beizubehalten, bei dem Remove- Cmdlets immer einen Wert zurückgegeben haben. Dieser Parameter wurde jetzt entfernt. Remove- Cmdlets geben nur einen Wert zurück, wenn -PassThru angegeben wird.

Vorher

$result = Remove-AzPolicyExemption -Name MyExemption -BackwardCompatible

Nach

$result = Remove-AzPolicyExemption -Name MyExemption -PassThru

Remove-AzPolicySetDefinition

Der BackwardCompatible Parameter wurde zuvor eingeführt, um das Legacyverhalten beizubehalten, bei dem Remove- Cmdlets immer einen Wert zurückgegeben haben. Dieser Parameter wurde jetzt entfernt. Remove- Cmdlets geben nur einen Wert zurück, wenn -PassThru angegeben wird.

Vorher

$result = Remove-AzPolicySetDefinition -Name MySetDefinition -BackwardCompatible

Nach

$result = Remove-AzPolicySetDefinition -Name MySetDefinition -PassThru

Update-AzPolicyAssignment

Der BackwardCompatibleParameter wurde zuvor eingeführt, um die auf .Properties-basierende Legacy-Ausgabeform beizubehalten. Dieser Parameter wurde jetzt entfernt. Cmdlets geben immer die moderne abgeflachte Objektstruktur zurück, und der Legacyzugriff über .Properties.* wird nicht mehr unterstützt. Skripts müssen aktualisiert werden, um direkt auf Erstklassige Eigenschaften zu verweisen.

Vorher

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

Nach

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

Update-AzPolicyDefinition

Der BackwardCompatibleParameter wurde zuvor eingeführt, um die auf .Properties-basierende Legacy-Ausgabeform beizubehalten. Dieser Parameter wurde jetzt entfernt. Cmdlets geben immer die moderne abgeflachte Objektstruktur zurück, und der Legacyzugriff über .Properties.* wird nicht mehr unterstützt. Skripts müssen aktualisiert werden, um direkt auf Erstklassige Eigenschaften zu verweisen.

Vorher

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

Nach

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

Update-AzPolicyExemption

Der BackwardCompatibleParameter wurde zuvor eingeführt, um die auf .Properties-basierende Legacy-Ausgabeform beizubehalten. Dieser Parameter wurde jetzt entfernt. Cmdlets geben immer die moderne abgeflachte Objektstruktur zurück, und der Legacyzugriff über .Properties.* wird nicht mehr unterstützt. Skripts müssen aktualisiert werden, um direkt auf Erstklassige Eigenschaften zu verweisen.

Vorher

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

Nach

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

Update-AzPolicySetDefinition

Der BackwardCompatibleParameter wurde zuvor eingeführt, um die auf .Properties-basierende Legacy-Ausgabeform beizubehalten. Dieser Parameter wurde jetzt entfernt. Cmdlets geben immer die moderne abgeflachte Objektstruktur zurück, und der Legacyzugriff über .Properties.* wird nicht mehr unterstützt. Skripts müssen aktualisiert werden, um direkt auf Erstklassige Eigenschaften zu verweisen.

Vorher

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

Nach

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

Az.Sql

New-AzSqlServer

  • Die Änderung der Parametertrennung erfolgt bei allen Parametersätzen - -EnableSoftDelete Der Parameter : 'EnableSoftDelete' wird geändert. - Beschreibung ändern: Der Parameter 'EnableSoftDelete' wird aus dem cmdlet New-AzSqlServer der Anwendung entfernt. - Diese Änderung wird am 2.6.2026 wirksam. - Die Änderung wird voraussichtlich ab Az-Version '16.0.0' wirksam. - Die Änderung wird voraussichtlich in 'Az.Sql' ab Version '7.0.0' wirksam.

Vorher

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

Nach

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

Set-AzSqlServer

  • Die Änderung der Parametertrennung erfolgt bei allen Parametersätzen - -EnableSoftDelete Der Parameter : 'EnableSoftDelete' wird geändert. - Beschreibung ändern: Der Parameter 'EnableSoftDelete' wird aus dem cmdlet Set-AzSqlServer der Anwendung entfernt. - Diese Änderung wird am 2.6.2026 wirksam. - Die Änderung wird voraussichtlich ab Az-Version '16.0.0' wirksam. - Die Änderung wird voraussichtlich in 'Az.Sql' ab Version '7.0.0' wirksam.

Vorher

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

Nach

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

Az.StackHCIVM

New-AzStackHCIVMImage

  • Parameterumbruchänderungen werden für alle Parametersätze vorgenommen.
    • -ImagePath

Vorher

ImagePath is of type 'string'

Nach

ImagePath has been changed to SecureString

New-AzStackHCIVMVirtualMachine

  • Parameterumbruchänderungen werden für alle Parametersätze vorgenommen.
    • -AdminPassword

Vorher

AdminPassword is of type 'string'

Nach

AdminPassword has been changed to SecureString

Az.StorageAction

Get-AzStorageActionTask

  • Cmdlet-Breaking-Change betrifft alle Parametersätze
    • Der Ausgabetyp 'Microsoft.Azure. PowerShell.Cmdlets.StorageAction.Models.IStorageTask' ändert sich
    • Die folgenden Eigenschaften im Ausgabetyp sind veraltet: 'IdentityUserAssignedIdentity'
    • Die folgenden Eigenschaften werden dem Ausgabetyp hinzugefügt: 'IdentityUserAssignedIdentity'
    • Änderungsbeschreibung: Die Typen der Eigenschaft "IdentityUserAssignedIdentity" werden von "Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IUserAssignedIdentities" zu "Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IManagedServiceIdentityUserAssignedIdentities" geändert.
    • Diese Änderung wird am 01.05.2026 wirksam - Die Änderung wird voraussichtlich ab der Az-Version: '16.0.0' wirksam.
    • Die Änderung wird voraussichtlich in "Az.StorageAction" ab Version '2.0.0' wirksam werden.

Vorher

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

Nach

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

New-AzStorageActionTask

  • Cmdlet-Breaking-Change betrifft alle Parametersätze
    • Der Ausgabetyp 'Microsoft.Azure. PowerShell.Cmdlets.StorageAction.Models.IStorageTask' ändert sich
    • Die folgenden Eigenschaften im Ausgabetyp sind veraltet: 'IdentityUserAssignedIdentity'
    • Die folgenden Eigenschaften werden dem Ausgabetyp hinzugefügt: 'IdentityUserAssignedIdentity'
    • Änderungsbeschreibung: Die Typen der Eigenschaft "IdentityUserAssignedIdentity" werden von "Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IUserAssignedIdentities" zu "Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IManagedServiceIdentityUserAssignedIdentities" geändert.
    • Diese Änderung wird am 01.05.2026 wirksam - Die Änderung wird voraussichtlich ab der Az-Version: '16.0.0' wirksam.
    • Die Änderung wird voraussichtlich in "Az.StorageAction" ab Version '2.0.0' wirksam werden.

Vorher

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

Nach

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

Update-AzStorageActionTask

  • Cmdlet-Breaking-Change betrifft alle Parametersätze
    • Der Ausgabetyp 'Microsoft.Azure. PowerShell.Cmdlets.StorageAction.Models.IStorageTask' ändert sich
    • Die folgenden Eigenschaften im Ausgabetyp sind veraltet: 'IdentityUserAssignedIdentity'
    • Die folgenden Eigenschaften werden dem Ausgabetyp hinzugefügt: 'IdentityUserAssignedIdentity'
    • Änderungsbeschreibung: Die Typen der Eigenschaft "IdentityUserAssignedIdentity" werden von "Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IUserAssignedIdentities" zu "Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IManagedServiceIdentityUserAssignedIdentities" geändert.
    • Diese Änderung wird am 01.05.2026 wirksam - Die Änderung wird voraussichtlich ab der Az-Version: '16.0.0' wirksam.
    • Die Änderung wird voraussichtlich in "Az.StorageAction" ab Version '2.0.0' wirksam werden.

Vorher

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

Nach

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

Von autorest v3 zu autorest v4 migrierte Module

Um die Verhaltenskonsistenz aufrechtzuerhalten und neue Features einzuführen, die von AutoRest v4 unterstützt werden, haben wir viele Module aktualisiert, um AutoRest v4 zu verwenden. Dieses Upgrade hat mehrere wichtige Änderungen eingeführt. Details zu möglichen umfassenden Änderungen und deren Mitigationsansätze finden Sie unter dem folgenden Link.

Potenziell betroffene Module

  • Az.CloudService
  • Az.ContainerInstance
  • Az.Databricks
  • Az.DataProtection
  • Az.DnsResolver
  • 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
  • Last updated on