Guida alla migrazione per Az 5.0.0

Articolo
04/30/2024

Questo documento descrive le modifiche apportate tra le versioni 4.0.0 e 5.0.0 del modulo Az.

Guida alla migrazione per Az 5.0.0

Az.Aks

New-AzAksCluster

Non supporta più il parametro NodeOsType e non è stato trovato alcun alias per il nome del parametro originale. Sarà sempre Linux.
Non supporta più l'alias ClientIdAndSecret per il parametro ServicePrincipalIdAndSecret.
Il valore predefinito di NodeVmSetType è cambiato da AvailabilitySet a VirtualMachineScaleSets.
Il valore predefinito di NetworkPlugin è cambiato da none a azure.

Prima

New-AzAksCluster -ResourceGroupName myResourceGroup -Name myCluster -WindowsProfileAdminUserName azureuser -WindowsProfileAdminUserPassword $cred -NetworkPlugin azure -NodeOsType Linux -ClientIdAndSecret xxx

Dopo

New-AzAksCluster -ResourceGroupName myResourceGroup -Name myCluster -WindowsProfileAdminUserName azureuser -WindowsProfileAdminUserPassword $cred -NodeVmSetType AvailabilitySet  -ServicePrincipalIdAndSecret xxx

Set-AzAksCluster

Non supporta più l'alias ClientIdAndSecret per il parametro ServicePrincipalIdAndSecret.

Prima

Get-AzAksCluster -ResourceGroupName xxx -Name xxx | Set-AzAksCluster -ClientIdAndSecret xxx

Dopo

Get-AzAksCluster -ResourceGroupName xxx -Name xxx | Set-AzAksCluster -ServicePrincipalIdAndSecret xxx

Az.ContainerRegistry

New-AzContainerRegistry

Non supporta più il parametro StorageAccountName e non è stato trovato alcun alias per il nome del parametro originale.

Prima

New-AzContainerRegistry -Name $name -ResourceGroupName $rg -Location $location -SKU Classic -StorageAccountName $storage

Dopo

Classic è stato deprecato e StorageAccountName è stato rimosso perché funziona solo con la versione classica di Registro Container.

Az.Functions

Get-AzFunctionApp

Il parametro opzionale IncludeSlot è stato rimosso da tutti i set di parametri di Get-AzFunctionApp tranne uno. Il cmdlet supporta ora il recupero degli slot di distribuzione nei risultati quando si specifica -IncludeSlot. Questa funzionalità non veniva eseguita correttamente nella versione precedente del cmdlet. Tuttavia, ora è stata corretta.

New-AzFunctionApp

Il parametro -DisableApplicationInsights di New-AzFunctionApp è stato corretto per cui quando questa opzione viene specificata non vengono creati progetti di Application Insights.
Il supporto per creare app per le funzioni di PowerShell 6.2 è stato rimosso dopo la data EOL di Poiché PowerShell 6.2. L'indicazione corrente per i clienti è di creare invece app per le funzioni di PowerShell 7.0.
La versione di runtime predefinita di Funzioni versione 3 è stata cambiata da 6.2 a 7.0 nelle app per le funzioni di Windows per PowerShell quando il parametro RuntimeVersion non viene specificato.
La versione di runtime predefinita di Funzioni versione 3 è stata cambiata da 10 a 12 nelle app per le funzioni di Windows e Linux per Node quando il parametro RuntimeVersion non viene specificato. Tuttavia, gli utenti possono comunque creare app per le funzioni di Node 10 specificando -Runtime Node e -RuntimeVersion 10. La versione di runtime predefinita di Funzioni versione 3 è stata cambiata da 3.7 a 3.8 nelle app per le funzioni di Linux per Python quando il parametro RuntimeVersion non viene specificato. Tuttavia, gli utenti possono comunque creare app per le funzioni di Python 3.7 specificando -Runtime Python e -RuntimeVersion 3.7.

Prima

# Create a Node 10 function app on Linux
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Linux `
                  -Runtime Node

# Create a Node 10 function app on Windows
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Windows `
                  -Runtime Node

# Create a Python 3.7 function app on Linux
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Linux `
                  -Runtime Python

Dopo

# Create a Node 10 function app on Linux
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Linux `
                  -Runtime Node `
                  -RuntimeVersion 10

# Create a Node 10 function app on Windows
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Windows `
                  -Runtime Node

# Create a Python 3.7 function app on Linux
New-AzFunctionApp -ResourceGroupName $rd `
                  -Name $functionAppName `
                  -StorageAccountName $storageAccountName `
                  -Location $location `
                  -OSType Linux `
                  -Runtime Python `
                  -RuntimeVersion 3.7

Az.KeyVault

New-AzKeyVault

Non supporta più il parametro DisableSoftDelete e non è stato trovato alcun alias per il nome del parametro originale.

Prima

# Opt out soft delete while creating a key vault
New-AzKeyVault -VaultName 'Contoso03Vault' -ResourceGroupName 'Group14' -Location 'East US' -DisableSoftDelete

Dopo

La possibilità di aggiornare l'impostazione dell'eliminazione temporanea è deprecata in Az.KeyVault 3.0.0. Altre informazioni

Update-AzKeyVault

Non supporta più i parametri EnableSoftDelete, SoftDeleteRetentionInDays e non è stato trovato alcun alias per il nome del parametro originale.

Prima

Update-AzKeyVault -VaultName 'Contoso03Vault' -ResourceGroupName 'Group14' -EnableSoftDelete -SoftDeleteRetentionInDays 15

Dopo

La possibilità di aggiornare l'impostazione dell'eliminazione temporanea è deprecata in Az.KeyVault 3.0.0. Altre informazioni

Get-AzKeyVaultSecret

La proprietà SecretValueText di tipo Microsoft.Azure.Commands.KeyVault.Models.PSKeyVaultSecret è stata rimossa. Applicare un oggetto -AsPlainText alla chiamata per ottenere il segreto di testo normale o usare $secret.SecretValue il tipo SecureString nello script.

Prima

$secret = Get-AzKeyVaultSecret -VaultName myVault -Name mySecret
$secretInPlainText = $secret.SecretValueText

Dopo

$secretInPlainText = Get-AzKeyVaultSecret -VaultName myVault -Name mySecret -AsPlainText

Az.ManagedServices

Get-AzManagedServicesDefinition

Non supporta più il parametro ResourceId e non è stato trovato alcun alias per il nome del parametro originale.

Prima

Get-AzManagedServicesDefinition -ResourceId xxx

Dopo

Get-AzManagedServicesDefinition -Id xxx

New-AzManagedServicesAssignment

Non supporta più i parametri RegistrationDefinitionName, RegistrationDefinitionResourceId e non è stato trovato alcun alias per il nome del parametro originale.

Prima

New-AzManagedServicesAssignment -RegistrationDefinitionName xxx -Scope xxx

Dopo

New-AzManagedServicesAssignment -Scope xxx -RegistrationDefinition xxx

Remove-AzManagedServicesAssignment

Non supporta più i parametri Id, ResourceId e non è stato trovato alcun alias per il nome del parametro originale.

Prima

Remove-AzManagedServicesAssignment -ResourceId xxx

Dopo

Get-AzManagedServicesAssignment -Scope xxx | Remove-AzManagedServicesAssignment

Remove-AzManagedServicesDefinition

Non supporta più i parametri Id, ResourceId e non è stato trovato alcun alias per il nome del parametro originale.

Prima

Remove-AzManagedServicesDefinition -ResourceId xxx

Dopo

Get-AzManagedServicesDefinition -Scope xxx | Remove-AzManagedServicesDefinition

Az.ResourceManager

Get-AzManagementGroupDeployment

Non supporta più il parametro ApiVersion e non è stato trovato alcun alias per il nome del parametro originale.

Prima

Get-AzManagementGroupDeployment -ManagementGroupId xxx -Name xxx -ApiVersion xxx