Guía de migración para Az 16.0.0

Az.DesktopVirtualization

Update-AzWvdApplication

  • El cambio rompedor de parámetros se producirá en todos los conjuntos de parámetros.
    • -Tag
      • El parámetro : 'Tag' está cambiando.
      • Cambiar descripción: el parámetro 'Tag' se eliminará del cmdlet Update de la aplicación.
      • Este cambio surtirá efecto en '6/2/2026'- Se espera que el cambio surta efecto desde la versión de Az : '16.0.0'
      • Se espera que el cambio surta efecto en "Az.DesktopVirtualization" de la versión : "6.0.0"

antes de

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

después de

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

Update-AzWvdDesktop

  • El cambio rompedor de parámetros se producirá en todos los conjuntos de parámetros.
    • -Tag
      • El parámetro : 'Tag' está cambiando.
      • Cambio de descripción: el parámetro 'Tag' se quitará del cmdlet Update de Desktop.
      • Este cambio surtirá efecto en '6/2/2026'- Se espera que el cambio surta efecto desde la versión de Az : '16.0.0'
      • Se espera que el cambio surta efecto en "Az.DesktopVirtualization" de la versión : "6.0.0"

antes de

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

después de

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

Az.NetworkCloud

Update-AzNetworkCloudVirtualMachine

  • El cambio importante del cmdlet se producirá en todos los conjuntos de parámetros: el cmdlet ya no admitirá los conjuntos de parámetros "JsonString" y "JsonFilePath". Se han quitado los conjuntos "UpdateViaJsonString" y "UpdateViaJsonFilePath". - Guía: actualice los scripts para usar los conjuntos de parámetros expandidos en lugar de pasar la entrada JSON. - Se espera que este cambio surta efecto el 1/5/2026, desde Az.NetworkCloud versión: 3.0.0 y Az version: 16.0.0

antes de

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

después de

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

Az.PolicyInsights

Get-AzPolicyAttestation

  • El "breaking-change" del cmdlet afectará a todos los conjuntos de parámetros.
    • El tipo de salida cambia del tipo existente :'Microsoft.Azure. Commands.PolicyInsights.Models.Attestations.PSAttestation' al nuevo tipo :'Attestation'
    • Las siguientes propiedades del tipo de salida están en desuso: "SystemData"
    • Se están agregando las siguientes propiedades al tipo de salida: 'ResourceGroupName', 'SystemDataCreatedAt', 'SystemDataCreatedBy', 'SystemDataCreatedByType', 'SystemDataLastModifiedAt', 'SystemDataLastModifiedBy', 'SystemDataLastModifiedByType'.
    • Se espera que este cambio surta efecto desde la versión de Az.PolicyInsights: 2.0.0 y Az version: 16.0.0

antes de

$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

después de

$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

  • El "breaking-change" del cmdlet afectará a todos los conjuntos de parámetros.
    • Tipo de salida "Microsoft.Azure. Commands.PolicyInsights.Models.PolicyEvent' está cambiando
    • Las siguientes propiedades del tipo de salida están en desuso: 'ResourceTags' 'ManagementGroupIds'
    • Se agregan las siguientes propiedades al tipo de salida : 'ResourceTag' 'ManagementGroupId' 'ComplianceState' 'Component' 'EffectiveParameter' 'OdataContext' 'OdataId' 'Keys' 'Values' 'Count' 'AdditionalProperties'
    • Se espera que este cambio surta efecto desde la versión de Az.PolicyInsights: 2.0.0 y Az version: 16.0.0

antes de

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

después de

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

Get-AzPolicyMetadata

  • El "breaking-change" del cmdlet afectará a todos los conjuntos de parámetros.
    • El tipo de salida cambia del tipo existente :'Microsoft.Azure. Commands.PolicyInsights.Models.PSPolicyMetadata' al nuevo tipo :'PolicyMetadata'
    • Se agregan las siguientes propiedades al tipo de salida : 'ResourceGroupName'
    • Se espera que este cambio surta efecto desde la versión de Az.PolicyInsights: 2.0.0 y Az version: 16.0.0

antes de

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

después de

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

Get-AzPolicyRemediation

  • El "breaking-change" del cmdlet afectará a todos los conjuntos de parámetros.
    • El tipo de salida cambia del tipo existente :'Microsoft.Azure. Commands.PolicyInsights.Models.Remediation.PSRemediation' al nuevo tipo :'Remediation'
    • Las siguientes propiedades del tipo de salida están consideradas obsoletas: 'Filters' 'DeploymentSummary' 'FailureThreshold' 'ParallelDeployments'
    • Se agregan las siguientes propiedades al tipo de salida : 'FilterLocation' 'FilterResourceId' 'DeploymentStatusFailedDeployment' 'DeploymentStatusSuccessfulDeployment' 'DeploymentStatusTotalDeployment' 'FailureThresholdPercentage' 'ParallelDeployment' 'ResourceGroupName' 'SystemDataCreatedAt' 'SystemDataCreatedBy' 'SystemDataCreatedByType' 'SystemDataLastModifiedAt' 'SystemDataLastModifiedBy' 'SystemDataLastModifiedByType'
    • Se espera que este cambio surta efecto desde la versión de Az.PolicyInsights: 2.0.0 y Az version: 16.0.0

antes de

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

después de

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

Get-AzPolicyState

  • El "breaking-change" del cmdlet afectará a todos los conjuntos de parámetros.
    • Tipo de salida 'Microsoft.Azure.Commands.PolicyInsights.Models.PolicyState' va a cambiar
    • Las siguientes propiedades del tipo de salida están en desuso: 'ResourceTags' 'ManagementGroupIds'
    • Se agregan las siguientes propiedades al tipo de salida : 'ResourceGroupName' 'ResourceTag' 'ManagementGroupId'
    • Se espera que este cambio surta efecto desde la versión de Az.PolicyInsights: 2.0.0 y Az version: 16.0.0

antes de

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

después de

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

Get-AzPolicyStateSummary

  • El "breaking-change" del cmdlet afectará a todos los conjuntos de parámetros.
    • Tipo de salida 'Microsoft.Azure.Commands.PolicyInsights.Models.PolicyStateSummary' va a cambiar.
    • Las siguientes propiedades del tipo de salida están obsoletas: 'PolicyAssignments', 'Results'
    • Las siguientes propiedades se agregan al tipo de salida: 'PolicyAssignment' 'ResultCompliantResource' 'ResultNonCompliantPolicy' 'ResultNonCompliantResource' 'ResultPolicyDetail' 'ResultPolicyGroupDetail' 'ResultQueryResultsUri' 'ResultResourceDetail' 'OdataId' 'OdataContext'
    • Se espera que este cambio surta efecto desde la versión de Az.PolicyInsights: 2.0.0 y Az version: 16.0.0

antes de

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

después de

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

New-AzPolicyAttestation

  • El "breaking-change" del cmdlet afectará a todos los conjuntos de parámetros.
    • El tipo de salida cambia del tipo existente :'Microsoft.Azure. Commands.PolicyInsights.Models.Attestations.PSAttestation' al nuevo tipo :'Attestation'
    • Las siguientes propiedades del tipo de salida están en desuso: "SystemData"
    • Se están agregando las siguientes propiedades al tipo de salida: 'ResourceGroupName', 'SystemDataCreatedAt', 'SystemDataCreatedBy', 'SystemDataCreatedByType', 'SystemDataLastModifiedAt', 'SystemDataLastModifiedBy', 'SystemDataLastModifiedByType'.
    • Se espera que este cambio surta efecto desde la versión de Az.PolicyInsights: 2.0.0 y Az version: 16.0.0

antes de

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

después de

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

Set-AzPolicyAttestation

  • El "breaking-change" del cmdlet afectará a todos los conjuntos de parámetros.
    • El tipo de salida cambia del tipo existente :'Microsoft.Azure. Commands.PolicyInsights.Models.Attestations.PSAttestation' al nuevo tipo :'Attestation'
    • Las siguientes propiedades del tipo de salida están en desuso: "SystemData"
    • Se están agregando las siguientes propiedades al tipo de salida: 'ResourceGroupName', 'SystemDataCreatedAt', 'SystemDataCreatedBy', 'SystemDataCreatedByType', 'SystemDataLastModifiedAt', 'SystemDataLastModifiedBy', 'SystemDataLastModifiedByType'.
    • Se espera que este cambio surta efecto desde la versión de Az.PolicyInsights: 2.0.0 y Az version: 16.0.0

antes de

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

después de

$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

  • El "breaking-change" del cmdlet afectará a todos los conjuntos de parámetros.
    • Start-AzPolicyRemediation ahora retornará cuando la remediación alcance un estado terminal a menos que use el nuevo parámetro NoWait.
    • Se espera que este cambio surta efecto desde la versión de Az.PolicyInsights: 2.0.0 y Az version: 16.0.0

antes de

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

después de

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

Stop-AzPolicyRemediation

  • El "breaking-change" del cmdlet afectará a todos los conjuntos de parámetros.
    • Stop-AzPolicyRemediation ahora tendrá un parámetro de modificador NoWait, así como devolver el objeto Remediation en lugar de simplemente un valor booleano.
    • Se espera que este cambio surta efecto desde la versión de Az.PolicyInsights: 2.0.0 y Az version: 16.0.0

antes de

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

después de

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

Az.Resources

Get-AzPolicyAssignment

El BackwardCompatible parámetro se introdujo anteriormente para conservar la forma de salida basada en la herencia .Properties. Este parámetro ahora se ha quitado. Los cmdlets siempre devuelven la estructura moderna y aplanada del objeto, y ya no se admite el acceso heredado a través de .Properties.*. Los scripts deben actualizarse para hacer referencia directamente a las propiedades de primera clase.

antes de

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

después de

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

Get-AzPolicyDefinition

El BackwardCompatible parámetro se introdujo anteriormente para conservar la forma de salida basada en la herencia .Properties. Este parámetro ahora se ha quitado. Los cmdlets siempre devuelven la estructura moderna y aplanada del objeto, y ya no se admite el acceso heredado a través de .Properties.*. Los scripts deben actualizarse para hacer referencia directamente a las propiedades de primera clase.

antes de

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

después de

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

Get-AzPolicyExemption

El BackwardCompatible parámetro se introdujo anteriormente para conservar la forma de salida basada en la herencia .Properties. Este parámetro ahora se ha quitado. Los cmdlets siempre devuelven la estructura moderna y aplanada del objeto, y ya no se admite el acceso heredado a través de .Properties.*. Los scripts deben actualizarse para hacer referencia directamente a las propiedades de primera clase.

antes de

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

después de

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

Get-AzPolicySetDefinition

El BackwardCompatible parámetro se introdujo anteriormente para conservar la forma de salida basada en la herencia .Properties. Este parámetro ahora se ha quitado. Los cmdlets siempre devuelven la estructura moderna y aplanada del objeto, y ya no se admite el acceso heredado a través de .Properties.*. Los scripts deben actualizarse para hacer referencia directamente a las propiedades de primera clase.

antes de

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

después de

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

New-AzPolicyAssignment

El BackwardCompatible parámetro se introdujo anteriormente para conservar la forma de salida basada en la herencia .Properties. Este parámetro ahora se ha quitado. Los cmdlets siempre devuelven la estructura moderna y aplanada del objeto, y ya no se admite el acceso heredado a través de .Properties.*. Los scripts deben actualizarse para hacer referencia directamente a las propiedades de primera clase.

antes de

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

después de

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

New-AzPolicyDefinition

El BackwardCompatible parámetro se introdujo anteriormente para conservar la forma de salida basada en la herencia .Properties. Este parámetro ahora se ha quitado. Los cmdlets siempre devuelven la estructura moderna y aplanada del objeto, y ya no se admite el acceso heredado a través de .Properties.*. Los scripts deben actualizarse para hacer referencia directamente a las propiedades de primera clase.

antes de

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

después de

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

New-AzPolicyExemption

El BackwardCompatible parámetro se introdujo anteriormente para conservar la forma de salida basada en la herencia .Properties. Este parámetro ahora se ha quitado. Los cmdlets siempre devuelven la estructura moderna y aplanada del objeto, y ya no se admite el acceso heredado a través de .Properties.*. Los scripts deben actualizarse para hacer referencia directamente a las propiedades de primera clase.

antes de

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

después de

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

New-AzPolicySetDefinition

El BackwardCompatible parámetro se introdujo anteriormente para conservar la forma de salida basada en la herencia .Properties. Este parámetro ahora se ha quitado. Los cmdlets siempre devuelven la estructura moderna y aplanada del objeto, y ya no se admite el acceso heredado a través de .Properties.*. Los scripts deben actualizarse para hacer referencia directamente a las propiedades de primera clase.

antes de

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

después de

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

Remove-AzPolicyAssignment

El BackwardCompatible parámetro se introdujo anteriormente para conservar el comportamiento heredado, donde Remove- los cmdlets siempre devolvieron un valor. Este parámetro ahora se ha quitado. Remove- los cmdlets solo devolverán un valor cuando -PassThru se especifique.

antes de

$result = Remove-AzPolicyAssignment -Name MyAssignment -BackwardCompatible

después de

$result = Remove-AzPolicyAssignment -Name MyAssignment -PassThru

Remove-AzPolicyDefinition

El BackwardCompatible parámetro se introdujo anteriormente para conservar el comportamiento heredado, donde Remove- los cmdlets siempre devolvieron un valor. Este parámetro ahora se ha quitado. Remove- los cmdlets solo devolverán un valor cuando -PassThru se especifique.

antes de

$result = Remove-AzPolicyDefinition -Name MyDefinition -BackwardCompatible

después de

$result = Remove-AzPolicyDefinition -Name MyDefinition -PassThru

Remove-AzPolicyExemption

El BackwardCompatible parámetro se introdujo anteriormente para conservar el comportamiento heredado, donde Remove- los cmdlets siempre devolvieron un valor. Este parámetro ahora se ha quitado. Remove- los cmdlets solo devolverán un valor cuando -PassThru se especifique.

antes de

$result = Remove-AzPolicyExemption -Name MyExemption -BackwardCompatible

después de

$result = Remove-AzPolicyExemption -Name MyExemption -PassThru

Remove-AzPolicySetDefinition

El BackwardCompatible parámetro se introdujo anteriormente para conservar el comportamiento heredado, donde Remove- los cmdlets siempre devolvieron un valor. Este parámetro ahora se ha quitado. Remove- los cmdlets solo devolverán un valor cuando -PassThru se especifique.

antes de

$result = Remove-AzPolicySetDefinition -Name MySetDefinition -BackwardCompatible

después de

$result = Remove-AzPolicySetDefinition -Name MySetDefinition -PassThru

Update-AzPolicyAssignment

El BackwardCompatible parámetro se introdujo anteriormente para conservar la forma de salida basada en la herencia .Properties. Este parámetro ahora se ha quitado. Los cmdlets siempre devuelven la estructura moderna y aplanada del objeto, y ya no se admite el acceso heredado a través de .Properties.*. Los scripts deben actualizarse para hacer referencia directamente a las propiedades de primera clase.

antes de

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

después de

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

Update-AzPolicyDefinition

El BackwardCompatible parámetro se introdujo anteriormente para conservar la forma de salida basada en la herencia .Properties. Este parámetro ahora se ha quitado. Los cmdlets siempre devuelven la estructura moderna y aplanada del objeto, y ya no se admite el acceso heredado a través de .Properties.*. Los scripts deben actualizarse para hacer referencia directamente a las propiedades de primera clase.

antes de

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

después de

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

Update-AzPolicyExemption

El BackwardCompatible parámetro se introdujo anteriormente para conservar la forma de salida basada en la herencia .Properties. Este parámetro ahora se ha quitado. Los cmdlets siempre devuelven la estructura moderna y aplanada del objeto, y ya no se admite el acceso heredado a través de .Properties.*. Los scripts deben actualizarse para hacer referencia directamente a las propiedades de primera clase.

antes de

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

después de

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

Update-AzPolicySetDefinition

El BackwardCompatible parámetro se introdujo anteriormente para conservar la forma de salida basada en la herencia .Properties. Este parámetro ahora se ha quitado. Los cmdlets siempre devuelven la estructura moderna y aplanada del objeto, y ya no se admite el acceso heredado a través de .Properties.*. Los scripts deben actualizarse para hacer referencia directamente a las propiedades de primera clase.

antes de

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

después de

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

Az.Sql

New-AzSqlServer

  • El cambio importante de parámetros se producirá en todos los conjuntos de parámetros: -EnableSoftDelete el parámetro : "EnableSoftDelete" está cambiando. - Descripción del cambio: el parámetro "EnableSoftDelete" se quitará del cmdlet New-AzSqlServer de la aplicación. - Este cambio surtirá efecto en '6/2/2026'- Se espera que el cambio surta efecto desde la versión de Az : '16.0.0': se espera que el cambio surta efecto en 'Az.Sql' desde la versión : '7.0.0'

antes de

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

después de

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

Set-AzSqlServer

  • El cambio importante de parámetros se producirá en todos los conjuntos de parámetros: -EnableSoftDelete el parámetro : "EnableSoftDelete" está cambiando. - Cambiar descripción: el parámetro "EnableSoftDelete" se quitará del cmdlet Set-AzSqlServer de Application. - Este cambio surtirá efecto en '6/2/2026'- Se espera que el cambio surta efecto desde la versión de Az : '16.0.0': se espera que el cambio surta efecto en 'Az.Sql' desde la versión : '7.0.0'

antes de

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

después de

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

Az.StackHCIVM

New-AzStackHCIVMImage

  • El cambio rompedor de parámetros se producirá en todos los conjuntos de parámetros.
    • -ImagePath

antes de

ImagePath is of type 'string'

después de

ImagePath has been changed to SecureString

New-AzStackHCIVMVirtualMachine

  • El cambio rompedor de parámetros se producirá en todos los conjuntos de parámetros.
    • -AdminPassword

antes de

AdminPassword is of type 'string'

después de

AdminPassword has been changed to SecureString

Az.StorageAction

Get-AzStorageActionTask

  • El "breaking-change" del cmdlet afectará a todos los conjuntos de parámetros.
    • Tipo de salida "Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IStorageTask" está cambiando.
    • Las siguientes propiedades del tipo de salida están en desuso: 'IdentityUserAssignedIdentity'
    • Se agregan las siguientes propiedades al tipo de salida : 'IdentityUserAssignedIdentity'
    • Cambiar descripción: los tipos de la propiedad "IdentityUserAssignedIdentity" se cambiarán de "Microsoft.Azure. PowerShell.Cmdlets.StorageAction.Models.IUserAssignedIdentities" a "Microsoft.Azure. PowerShell.Cmdlets.StorageAction.Models.IManagedServiceIdentityUserAssignedIdentities'
    • Este cambio surtirá efecto en '5/1/2026'- Se espera que el cambio surta efecto desde la versión de Az : '16.0.0'
    • Se espera que el cambio surta efecto en "Az.StorageAction" de la versión : "2.0.0".

antes de

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

después de

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

New-AzStorageActionTask

  • El "breaking-change" del cmdlet afectará a todos los conjuntos de parámetros.
    • Tipo de salida "Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IStorageTask" está cambiando.
    • Las siguientes propiedades del tipo de salida están en desuso: 'IdentityUserAssignedIdentity'
    • Se agregan las siguientes propiedades al tipo de salida : 'IdentityUserAssignedIdentity'
    • Cambiar descripción: los tipos de la propiedad "IdentityUserAssignedIdentity" se cambiarán de "Microsoft.Azure. PowerShell.Cmdlets.StorageAction.Models.IUserAssignedIdentities" a "Microsoft.Azure. PowerShell.Cmdlets.StorageAction.Models.IManagedServiceIdentityUserAssignedIdentities'
    • Este cambio surtirá efecto en '5/1/2026'- Se espera que el cambio surta efecto desde la versión de Az : '16.0.0'
    • Se espera que el cambio surta efecto en "Az.StorageAction" de la versión : "2.0.0".

antes de

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

después de

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

Update-AzStorageActionTask

  • El "breaking-change" del cmdlet afectará a todos los conjuntos de parámetros.
    • Tipo de salida "Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IStorageTask" está cambiando.
    • Las siguientes propiedades del tipo de salida están en desuso: 'IdentityUserAssignedIdentity'
    • Se agregan las siguientes propiedades al tipo de salida : 'IdentityUserAssignedIdentity'
    • Cambiar descripción: los tipos de la propiedad "IdentityUserAssignedIdentity" se cambiarán de "Microsoft.Azure. PowerShell.Cmdlets.StorageAction.Models.IUserAssignedIdentities" a "Microsoft.Azure. PowerShell.Cmdlets.StorageAction.Models.IManagedServiceIdentityUserAssignedIdentities'
    • Este cambio surtirá efecto en '5/1/2026'- Se espera que el cambio surta efecto desde la versión de Az : '16.0.0'
    • Se espera que el cambio surta efecto en "Az.StorageAction" de la versión : "2.0.0".

antes de

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

después de

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

Módulos migrados de autorest v3 a autorest v4

Para mantener la coherencia del comportamiento e introducir nuevas características compatibles con AutoRest v4, hemos actualizado muchos módulos para usar AutoRest v4. Esta actualización ha introducido varios cambios importantes. Puede encontrar detalles sobre los posibles cambios importantes y sus enfoques de mitigación en el siguiente vínculo.

Módulos potencialmente afectados

  • 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