Guia de Migração para Az 16.0.0

Az.DesktopVirtualization

Update-AzWvdApplication

  • Uma alteração de parâmetros ocorrerá em todos os conjuntos de parâmetros.
    • -Tag
      • O parâmetro : 'Tag' está a mudar.
      • Alterar a descrição: O parâmetro 'Tag' será removido do cmdlet de Atualização da Aplicação.
      • Esta alteração entrará em vigor a '2/6/2026' - Espera-se que a alteração entre em vigor a partir da versão do Arizona: '16.0.0'
      • Espera-se que a alteração entre em vigor no 'Az.DesktopVirtualization' a partir da versão: '6.0.0'

Antes

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

Depois de

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

Update-AzWvdDesktop

  • Uma alteração de parâmetros ocorrerá em todos os conjuntos de parâmetros.
    • -Tag
      • O parâmetro : 'Tag' está a mudar.
      • Alterar a descrição: O parâmetro 'Tag' será removido do cmdlet Update do Desktop.
      • Esta alteração entrará em vigor a '2/6/2026' - Espera-se que a alteração entre em vigor a partir da versão do Arizona: '16.0.0'
      • Espera-se que a alteração entre em vigor no 'Az.DesktopVirtualization' a partir da versão: '6.0.0'

Antes

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

Depois de

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

Az.NetworkCloud

Update-AzNetworkCloudVirtualMachine

  • A mudança de quebra do cmdlet acontecerá em todos os conjuntos de parâmetros - O cmdlet deixará de suportar os conjuntos de parâmetros 'JsonString' e 'JsonFilePath'. Os conjuntos 'UpdateViaJsonString' e 'UpdateViaJsonFilePath' foram removidos. - Orientação: Atualizar scripts para usar os conjuntos de parâmetros expandidos em vez de passar input JSON. - Espera-se que esta alteração entre em vigor a 1/05/2026, a partir da versão 3.0.0 do Az.NetworkCloud e da versão 16.0.0 do Az.

Antes

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

Depois de

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

Az.PolicyInsights

Get-AzPolicyAttestation

  • A alteração disruptiva do cmdlet ocorrerá em todos os conjuntos de parâmetros
    • O tipo de saída está a mudar do tipo existente: 'Microsoft.Azure.Commands.PolicyInsights.Models.Attestations.PSAttestation' para o novo tipo: 'Attestation'
    • As seguintes propriedades no tipo de saída estão a ser obsoletas: 'SystemData'
    • As seguintes propriedades estão a ser adicionadas ao tipo de saída: 'NomeGrupoDeRecursos' 'SystemDataCreatedAt' 'SystemDataCreatedBy' 'SystemDataCreatedByType' 'SystemDataLastModifiedAt' 'SystemDataLastModifiedBy' 'SystemDataLastModifiedByType'
    • Espera-se que esta alteração entre em vigor a partir da versão 2.0.0 do Az.PolicyInsights e da versão 16.0.0 do Az.

Antes

$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

Depois 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

  • A alteração disruptiva do cmdlet ocorrerá em todos os conjuntos de parâmetros
    • O tipo de saída 'Microsoft.Azure.Commands.PolicyInsights.Models.PolicyEvent' vai mudar
    • As seguintes propriedades no tipo de saída estão a ser descontinuadas: 'ResourceTags' 'ManagementGroupIds'
    • As seguintes propriedades estão a ser adicionadas ao tipo de saída: 'ResourceTag' 'ManagementGroupId' 'ComplianceState' 'Componente' 'Parâmetro Eficaz' 'OdataContext' 'OdataId' 'Chaves' 'Valores' 'Contagem' 'Propriedades Adicionais'
    • Espera-se que esta alteração entre em vigor a partir da versão 2.0.0 do Az.PolicyInsights e da versão 16.0.0 do Az.

Antes

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

Depois de

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

Get-AzPolicyMetadata

  • A alteração disruptiva do cmdlet ocorrerá em todos os conjuntos de parâmetros
    • O tipo de saída está a mudar em relação ao tipo existente: 'Microsoft.Azure. Commands.PolicyInsights.Models.PSPolicyMetadata' para o novo tipo :'PolicyMetadata'
    • As seguintes propriedades estão a ser adicionadas ao tipo de saída: 'ResourceGroupName'
    • Espera-se que esta alteração entre em vigor a partir da versão 2.0.0 do Az.PolicyInsights e da versão 16.0.0 do Az.

Antes

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

Depois de

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

Get-AzPolicyRemediation

  • A alteração disruptiva do cmdlet ocorrerá em todos os conjuntos de parâmetros
    • O tipo de saída está a mudar do tipo existente: 'Microsoft.Azure.Commands.PolicyInsights.Models.Remediation.PSRemediation' para o novo tipo: 'Remediation'
    • As seguintes propriedades no tipo de saída estão a ser descontinuadas: 'Filtros', 'DeploymentSummary', 'FailureThreshold', 'ParallelDeployments'
    • As seguintes propriedades estão a ser adicionadas ao tipo de saída: 'FilterLocation' 'FilterResourceId' 'DeploymentStatusFailedDeployment' 'DeploymentStatusSuccessfulDeployment' 'DeploymentStatusTotalDeployment' 'FailureThresholdPercentage' 'ParallelDeployment' 'ResourceGroupName' 'SystemDataCreatedAt' 'SystemDataCreatedBy' 'SystemDataCreatedByType' 'SystemDataLastModifiedAt' 'SystemDataLastModifiedBy' 'SystemDataLastModifiedByType'
    • Espera-se que esta alteração entre em vigor a partir da versão 2.0.0 do Az.PolicyInsights e da versão 16.0.0 do Az.

Antes

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

Depois de

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

Get-AzPolicyState

  • A alteração disruptiva do cmdlet ocorrerá em todos os conjuntos de parâmetros
    • O tipo de saída "Microsoft.Azure.Commands.PolicyInsights.Models.PolicyState" está a alterar-se
    • As seguintes propriedades no tipo de saída estão a ser descontinuadas: 'ResourceTags' 'ManagementGroupIds'
    • As seguintes propriedades estão a ser adicionadas ao tipo de saída: 'ResourceGroupName' 'ResourceTag' 'ManagementGroupId'
    • Espera-se que esta alteração entre em vigor a partir da versão 2.0.0 do Az.PolicyInsights e da versão 16.0.0 do Az.

Antes

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

Depois de

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

Get-AzPolicyStateSummary

  • A alteração disruptiva do cmdlet ocorrerá em todos os conjuntos de parâmetros
    • O tipo de saída 'Microsoft.Azure.Commands.PolicyInsights.Models.PolicyStateSummary' está a mudar
    • As seguintes propriedades do tipo de saída estão a ser descontinuadas: 'PolicyAssignments', 'Results'
    • As seguintes propriedades estão a ser adicionadas ao tipo de saída: 'PolicyAssignment' 'ResultCompliantResource' 'ResultNonCompliantPolicy' 'ResultNonCompliantResource' 'ResultPolicyDetail' 'ResultPolicyGroupDetail' 'ResultQueryResultsUri' 'ResultResourceDetail' 'OdataId' 'OdataContext'
    • Espera-se que esta alteração entre em vigor a partir da versão 2.0.0 do Az.PolicyInsights e da versão 16.0.0 do Az.

Antes

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

Depois de

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

New-AzPolicyAttestation

  • A alteração disruptiva do cmdlet ocorrerá em todos os conjuntos de parâmetros
    • O tipo de saída está a mudar do tipo existente: 'Microsoft.Azure.Commands.PolicyInsights.Models.Attestations.PSAttestation' para o novo tipo: 'Attestation'
    • As seguintes propriedades no tipo de saída estão a ser obsoletas: 'SystemData'
    • As seguintes propriedades estão a ser adicionadas ao tipo de saída: 'NomeGrupoDeRecursos' 'SystemDataCreatedAt' 'SystemDataCreatedBy' 'SystemDataCreatedByType' 'SystemDataLastModifiedAt' 'SystemDataLastModifiedBy' 'SystemDataLastModifiedByType'
    • Espera-se que esta alteração entre em vigor a partir da versão 2.0.0 do Az.PolicyInsights e da versão 16.0.0 do Az.

Antes

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

Depois de

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

Set-AzPolicyAttestation

  • A alteração disruptiva do cmdlet ocorrerá em todos os conjuntos de parâmetros
    • O tipo de saída está a mudar do tipo existente: 'Microsoft.Azure.Commands.PolicyInsights.Models.Attestations.PSAttestation' para o novo tipo: 'Attestation'
    • As seguintes propriedades no tipo de saída estão a ser obsoletas: 'SystemData'
    • As seguintes propriedades estão a ser adicionadas ao tipo de saída: 'NomeGrupoDeRecursos' 'SystemDataCreatedAt' 'SystemDataCreatedBy' 'SystemDataCreatedByType' 'SystemDataLastModifiedAt' 'SystemDataLastModifiedBy' 'SystemDataLastModifiedByType'
    • Espera-se que esta alteração entre em vigor a partir da versão 2.0.0 do Az.PolicyInsights e da versão 16.0.0 do Az.

Antes

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

Depois 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

  • A alteração disruptiva do cmdlet ocorrerá em todos os conjuntos de parâmetros
    • Start-AzPolicyRemediation agora retornará quando a remediação atingir um estado terminal, a menos que seja usado o novo parâmetro NoWait.
    • Espera-se que esta alteração entre em vigor a partir da versão 2.0.0 do Az.PolicyInsights e da versão 16.0.0 do Az.

Antes

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

Depois de

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

Stop-AzPolicyRemediation

  • A alteração disruptiva do cmdlet ocorrerá em todos os conjuntos de parâmetros
    • Stop-AzPolicyRemediation agora terá um parâmetro switch NoWait e também retornará o objeto de remediação em vez de apenas um valor booleano.
    • Espera-se que esta alteração entre em vigor a partir da versão 2.0.0 do Az.PolicyInsights e da versão 16.0.0 do Az.

Antes

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

Depois de

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

Az.Recursos

Get-AzPolicyAssignment

O parâmetro BackwardCompatible foi introduzido anteriormente para preservar o formato de saída antigo baseado em .Properties. Este parâmetro foi agora removido. Os cmdlets devolvem sempre a forma moderna do objeto achatado, e o acesso legado via .Properties.* já não é suportado. Os scripts devem ser atualizados para referenciar diretamente propriedades de primeira classe.

Antes

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

Depois de

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

Get-AzPolicyDefinition

O parâmetro BackwardCompatible foi introduzido anteriormente para preservar o formato de saída antigo baseado em .Properties. Este parâmetro foi agora removido. Os cmdlets devolvem sempre a forma moderna do objeto achatado, e o acesso legado via .Properties.* já não é suportado. Os scripts devem ser atualizados para referenciar diretamente propriedades de primeira classe.

Antes

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

Depois de

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

Get-AzPolicyExemption

O parâmetro BackwardCompatible foi introduzido anteriormente para preservar o formato de saída antigo baseado em .Properties. Este parâmetro foi agora removido. Os cmdlets devolvem sempre a forma moderna do objeto achatado, e o acesso legado via .Properties.* já não é suportado. Os scripts devem ser atualizados para referenciar diretamente propriedades de primeira classe.

Antes

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

Depois de

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

Get-AzPolicySetDefinition

O parâmetro BackwardCompatible foi introduzido anteriormente para preservar o formato de saída antigo baseado em .Properties. Este parâmetro foi agora removido. Os cmdlets devolvem sempre a forma moderna do objeto achatado, e o acesso legado via .Properties.* já não é suportado. Os scripts devem ser atualizados para referenciar diretamente propriedades de primeira classe.

Antes

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

Depois de

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

New-AzPolicyAssignment

O parâmetro BackwardCompatible foi introduzido anteriormente para preservar o formato de saída antigo baseado em .Properties. Este parâmetro foi agora removido. Os cmdlets devolvem sempre a forma moderna do objeto achatado, e o acesso legado via .Properties.* já não é suportado. Os scripts devem ser atualizados para referenciar diretamente propriedades de primeira classe.

Antes

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

Depois de

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

New-AzPolicyDefinition

O parâmetro BackwardCompatible foi introduzido anteriormente para preservar o formato de saída antigo baseado em .Properties. Este parâmetro foi agora removido. Os cmdlets devolvem sempre a forma moderna do objeto achatado, e o acesso legado via .Properties.* já não é suportado. Os scripts devem ser atualizados para referenciar diretamente propriedades de primeira classe.

Antes

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

Depois de

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

New-AzPolicyExemption

O parâmetro BackwardCompatible foi introduzido anteriormente para preservar o formato de saída antigo baseado em .Properties. Este parâmetro foi agora removido. Os cmdlets devolvem sempre a forma moderna do objeto achatado, e o acesso legado via .Properties.* já não é suportado. Os scripts devem ser atualizados para referenciar diretamente propriedades de primeira classe.

Antes

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

Depois de

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

New-AzPolicySetDefinition

O parâmetro BackwardCompatible foi introduzido anteriormente para preservar o formato de saída antigo baseado em .Properties. Este parâmetro foi agora removido. Os cmdlets devolvem sempre a forma moderna do objeto achatado, e o acesso legado via .Properties.* já não é suportado. Os scripts devem ser atualizados para referenciar diretamente propriedades de primeira classe.

Antes

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

Depois de

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

Remove-AzPolicyAssignment

O BackwardCompatible parâmetro foi anteriormente introduzido para preservar o comportamento legado, onde Remove- os cmdlets devolviam sempre um valor. Este parâmetro foi agora removido. Remove- Os cmdlets só devolvem um valor quando -PassThru for especificado.

Antes

$result = Remove-AzPolicyAssignment -Name MyAssignment -BackwardCompatible

Depois de

$result = Remove-AzPolicyAssignment -Name MyAssignment -PassThru

Remove-AzPolicyDefinition

O BackwardCompatible parâmetro foi anteriormente introduzido para preservar o comportamento legado, onde Remove- os cmdlets devolviam sempre um valor. Este parâmetro foi agora removido. Remove- Os cmdlets só devolvem um valor quando -PassThru for especificado.

Antes

$result = Remove-AzPolicyDefinition -Name MyDefinition -BackwardCompatible

Depois de

$result = Remove-AzPolicyDefinition -Name MyDefinition -PassThru

Remove-AzPolicyExemption

O BackwardCompatible parâmetro foi anteriormente introduzido para preservar o comportamento legado, onde Remove- os cmdlets devolviam sempre um valor. Este parâmetro foi agora removido. Remove- Os cmdlets só devolvem um valor quando -PassThru for especificado.

Antes

$result = Remove-AzPolicyExemption -Name MyExemption -BackwardCompatible

Depois de

$result = Remove-AzPolicyExemption -Name MyExemption -PassThru

Remove-AzPolicySetDefinition

O BackwardCompatible parâmetro foi anteriormente introduzido para preservar o comportamento legado, onde Remove- os cmdlets devolviam sempre um valor. Este parâmetro foi agora removido. Remove- Os cmdlets só devolvem um valor quando -PassThru for especificado.

Antes

$result = Remove-AzPolicySetDefinition -Name MySetDefinition -BackwardCompatible

Depois de

$result = Remove-AzPolicySetDefinition -Name MySetDefinition -PassThru

Update-AzPolicyAssignment

O parâmetro BackwardCompatible foi introduzido anteriormente para preservar o formato de saída antigo baseado em .Properties. Este parâmetro foi agora removido. Os cmdlets devolvem sempre a forma moderna do objeto achatado, e o acesso legado via .Properties.* já não é suportado. Os scripts devem ser atualizados para referenciar diretamente propriedades de primeira classe.

Antes

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

Depois de

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

Update-AzPolicyDefinition

O parâmetro BackwardCompatible foi introduzido anteriormente para preservar o formato de saída antigo baseado em .Properties. Este parâmetro foi agora removido. Os cmdlets devolvem sempre a forma moderna do objeto achatado, e o acesso legado via .Properties.* já não é suportado. Os scripts devem ser atualizados para referenciar diretamente propriedades de primeira classe.

Antes

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

Depois de

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

Update-AzPolicyExemption

O parâmetro BackwardCompatible foi introduzido anteriormente para preservar o formato de saída antigo baseado em .Properties. Este parâmetro foi agora removido. Os cmdlets devolvem sempre a forma moderna do objeto achatado, e o acesso legado via .Properties.* já não é suportado. Os scripts devem ser atualizados para referenciar diretamente propriedades de primeira classe.

Antes

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

Depois de

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

Update-AzPolicySetDefinition

O parâmetro BackwardCompatible foi introduzido anteriormente para preservar o formato de saída antigo baseado em .Properties. Este parâmetro foi agora removido. Os cmdlets devolvem sempre a forma moderna do objeto achatado, e o acesso legado via .Properties.* já não é suportado. Os scripts devem ser atualizados para referenciar diretamente propriedades de primeira classe.

Antes

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

Depois de

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

Az.Sql

New-AzSqlServer

  • A alteração de quebra de parâmetros acontecerá em todos os conjuntos de parâmetros - -EnableSoftDelete - O parâmetro : 'EnableSoftDelete' está a mudar. - Alterar a descrição: O parâmetro 'EnableSoftDelete' será removido do New-AzSqlServer cmdlet da Application. - Esta alteração entrará em vigor a 2/06/2026 - Espera-se que a alteração entre em vigor a partir da versão do Az: '16.0.0' - Espera-se que a alteração entre em vigor no 'Az.Sql' a partir da versão: '7.0.0'

Antes

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

Depois de

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

Set-AzSqlServer

  • A alteração de quebra de parâmetros acontecerá em todos os conjuntos de parâmetros - -EnableSoftDelete - O parâmetro : 'EnableSoftDelete' está a mudar. - Alterar a descrição: O parâmetro 'EnableSoftDelete' será removido do Set-AzSqlServer cmdlet da Application. - Esta alteração entrará em vigor a 2/06/2026 - Espera-se que a alteração entre em vigor a partir da versão do Az: '16.0.0' - Espera-se que a alteração entre em vigor no 'Az.Sql' a partir da versão: '7.0.0'

Antes

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

Depois de

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

Az.StackHCIVM

New-AzStackHCIVMImage

  • Uma alteração de parâmetros ocorrerá em todos os conjuntos de parâmetros.
    • -ImagePath

Antes

ImagePath is of type 'string'

Depois de

ImagePath has been changed to SecureString

New-AzStackHCIVMVirtualMachine

  • Uma alteração de parâmetros ocorrerá em todos os conjuntos de parâmetros.
    • -AdminPassword

Antes

AdminPassword is of type 'string'

Depois de

AdminPassword has been changed to SecureString

Az.StorageAction

Get-AzStorageActionTask

  • A alteração disruptiva do cmdlet ocorrerá em todos os conjuntos de parâmetros
    • O tipo de saída 'Microsoft.Azure. PowerShell.Cmdlets.StorageAction.Models.IStorageTask' está a mudar
    • As seguintes propriedades no tipo de saída estão a ser descontinuadas: 'IdentityUserAssignedIdentity'
    • As seguintes propriedades estão a ser adicionadas ao tipo de saída: 'IdentidadeAtribuídaPeloUtilizador'
    • Alterar a descrição: Os tipos da propriedade 'IdentityUserAssignedIdentity' serão alterados de 'Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IUserAssignedIdentities' para 'Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IManagedServiceIdentityUserAssignedIdentities'
    • Esta alteração entrará em vigor a '5/1/2026' - Espera-se que a alteração entre em vigor a partir da versão do Arizona: '16.0.0'
    • Espera-se que a alteração entre em vigor em 'Az.StorageAction' a partir da versão: '2.0.0'

Antes

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

Depois de

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

New-AzStorageActionTask

  • A alteração disruptiva do cmdlet ocorrerá em todos os conjuntos de parâmetros
    • O tipo de saída 'Microsoft.Azure. PowerShell.Cmdlets.StorageAction.Models.IStorageTask' está a mudar
    • As seguintes propriedades no tipo de saída estão a ser descontinuadas: 'IdentityUserAssignedIdentity'
    • As seguintes propriedades estão a ser adicionadas ao tipo de saída: 'IdentidadeAtribuídaPeloUtilizador'
    • Alterar a descrição: Os tipos da propriedade 'IdentityUserAssignedIdentity' serão alterados de 'Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IUserAssignedIdentities' para 'Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IManagedServiceIdentityUserAssignedIdentities'
    • Esta alteração entrará em vigor a '5/1/2026' - Espera-se que a alteração entre em vigor a partir da versão do Arizona: '16.0.0'
    • Espera-se que a alteração entre em vigor em 'Az.StorageAction' a partir da versão: '2.0.0'

Antes

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

Depois de

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

Update-AzStorageActionTask

  • A alteração disruptiva do cmdlet ocorrerá em todos os conjuntos de parâmetros
    • O tipo de saída 'Microsoft.Azure. PowerShell.Cmdlets.StorageAction.Models.IStorageTask' está a mudar
    • As seguintes propriedades no tipo de saída estão a ser descontinuadas: 'IdentityUserAssignedIdentity'
    • As seguintes propriedades estão a ser adicionadas ao tipo de saída: 'IdentidadeAtribuídaPeloUtilizador'
    • Alterar a descrição: Os tipos da propriedade 'IdentityUserAssignedIdentity' serão alterados de 'Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IUserAssignedIdentities' para 'Microsoft.Azure.PowerShell.Cmdlets.StorageAction.Models.IManagedServiceIdentityUserAssignedIdentities'
    • Esta alteração entrará em vigor a '5/1/2026' - Espera-se que a alteração entre em vigor a partir da versão do Arizona: '16.0.0'
    • Espera-se que a alteração entre em vigor em 'Az.StorageAction' a partir da versão: '2.0.0'

Antes

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

Depois de

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

Os módulos migraram do autorest v3 para o autorest v4

Para manter a consistência comportamental e introduzir novas funcionalidades suportadas pelo AutoRest v4, atualizámos muitos módulos para usar o AutoRest v4. Esta atualização introduziu várias mudanças decisivas. Detalhes sobre possíveis alterações que podem causar interrupções e as suas abordagens de mitigação podem ser encontrados no link abaixo.

Módulos potencialmente afetados

  • Az.CloudService
  • Az.ContainerInstance
  • Az.Databricks
  • Az.Proteção de Dados
  • Az.DnsResolver
  • Az.Functions
  • Az.Kusto
  • Az.LoadTesting
  • Az.MachineLearningServices
  • Az.ManagedServices
  • Az.Migrar
  • Az.Monitor
  • Az.MySql
  • Az.RedisEnterpriseCache
  • Az.ResourceMover
  • Az.SecurityInsights
  • Az.SignalR
  • Az.SqlVirtualMachine
  • Az.StackHCI
  • Az.Websites