Condividi tramite


Guida alla migrazione per Az 5.0.0

Questo documento descrive le modifiche tra le versioni 4.0.0 e 5.0.0 di Az.

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 viene modificato da AvailabilitySet a VirtualMachineScaleSets.
  • Il valore predefinito di NetworkPlugin viene modificato da none a azure.

Prima di

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 di

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 di

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

Dopo

Classic è stato deprecato ed StorageAccountName è stato rimosso perché funziona solo con il registro contenitori classico.

Az.Functions

Get-AzFunctionApp

Rimozione del IncludeSlot parametro switch da tutti i set di parametri tranne un set di parametri di Get-AzFunctionApp. Il cmdlet supporta ora il recupero degli slot di distribuzione nei risultati quando -IncludeSlot viene specificato. Questa funzionalità è stata interrotta nella versione precedente del cmdlet. Tuttavia, questa operazione è stata risolta.

New-AzFunctionApp

  • Correzione di -DisableApplicationInsights in New-AzFunctionApp in modo che non venga creato alcun progetto application insights quando questa opzione viene specificata.
  • È stato rimosso il supporto per creare app per le funzioni di PowerShell 6.2 a partire da PowerShell 6.2. Le linee guida correnti per i clienti sono la creazione di app per le funzioni di PowerShell 7.0.
  • Modifica della versione di runtime predefinita in Funzioni versione 3 in Windows per le app per le funzioni di PowerShell da 6.2 a 7.0 quando il RuntimeVersion parametro non è specificato.
  • Modifica della versione di runtime predefinita in Funzioni versione 3 in Windows e Linux per le app per le funzioni Node da 10 a 12 quando il RuntimeVersion parametro non è specificato. Tuttavia, gli utenti possono comunque creare app per le funzioni Node 10 specificando -Runtime Node e -RuntimeVersion 10. Modifica della versione di runtime predefinita in Funzioni versione 3 in Linux per le app per le funzioni Python da 3.7 a 3.8 quando il RuntimeVersion parametro non è specificato. Tuttavia, gli utenti possono comunque creare app per le funzioni Python 3.7 specificando -Runtime Python e -RuntimeVersion 3.7.

Prima di

# 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 di

# 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 di eliminazione temporanea è deprecata in Az.KeyVault 3.0.0. Altre informazioni

Update-AzKeyVault

Non supporta più il parametro EnableSoftDelete, SoftDeleteRetentionInDayse non è stato trovato alcun alias per il nome del parametro originale.

Prima di

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

Dopo

La possibilità di aggiornare l'impostazione di 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 di

$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 di

Get-AzManagedServicesDefinition -ResourceId xxx

Dopo

Get-AzManagedServicesDefinition -Id xxx

New-AzManagedServicesAssignment

Non supporta più il parametro RegistrationDefinitionName, RegistrationDefinitionResourceIde non è stato trovato alcun alias per il nome del parametro originale.

Prima di

New-AzManagedServicesAssignment -RegistrationDefinitionName xxx -Scope xxx

Dopo

New-AzManagedServicesAssignment -Scope xxx -RegistrationDefinition xxx

Remove-AzManagedServicesAssignment

Non supporta più il parametro Id, ResourceIde non è stato trovato alcun alias per il nome del parametro originale.

Prima di

Remove-AzManagedServicesAssignment -ResourceId xxx

Dopo

Get-AzManagedServicesAssignment -Scope xxx | Remove-AzManagedServicesAssignment

Remove-AzManagedServicesDefinition

Non supporta più il parametro Id, ResourceIde non è stato trovato alcun alias per il nome del parametro originale.

Prima di

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 di

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

Dopo

Get-AzManagementGroupDeployment -ManagementGroupId xxx -Name xxx

Get-AzManagementGroupDeploymentOperation

Uguale a Get-AzManagementGroupDeployment.

Get-AzDeployment

Uguale a Get-AzManagementGroupDeployment.

Get-AzDeploymentOperation

Uguale a Get-AzManagementGroupDeployment.

Get-AzDeploymentWhatIfResult

Uguale a Get-AzManagementGroupDeployment.

Get-AzTenantDeployment

Uguale a Get-AzManagementGroupDeployment.

Get-AzTenantDeploymentOperation

Uguale a Get-AzManagementGroupDeployment.

New-AzManagementGroupDeployment

Uguale a Get-AzManagementGroupDeployment.

New-AzDeployment

Uguale a Get-AzManagementGroupDeployment.

New-AzTenantDeployment

Uguale a Get-AzManagementGroupDeployment.

Remove-AzManagementGroupDeployment

Uguale a Get-AzManagementGroupDeployment.

Remove-AzDeployment

Uguale a Get-AzManagementGroupDeployment.

Remove-AzTenantDeployment

Uguale a Get-AzManagementGroupDeployment.

Save-AzManagementGroupDeploymentTemplate

Uguale a Get-AzManagementGroupDeployment.

Save-AzDeploymentTemplate

Uguale a Get-AzManagementGroupDeployment.

Save-AzTenantDeploymentTemplate

Uguale a Get-AzManagementGroupDeployment.

Stop-AzManagementGroupDeployment

Uguale a Get-AzManagementGroupDeployment.

Stop-AzDeployment

Uguale a Get-AzManagementGroupDeployment.

Stop-AzTenantDeployment

Uguale a Get-AzManagementGroupDeployment.

Test-AzManagementGroupDeployment

Uguale a Get-AzManagementGroupDeployment.

Test-AzDeployment

Uguale a Get-AzManagementGroupDeployment.

Test-AzTenantDeployment

Uguale a Get-AzManagementGroupDeployment.

Get-AzResourceGroupDeployment

Uguale a Get-AzManagementGroupDeployment.

Get-AzResourceGroupDeploymentOperation

Uguale a Get-AzManagementGroupDeployment.

Get-AzResourceGroupDeploymentWhatIfResult

Uguale a Get-AzManagementGroupDeployment.

New-AzResourceGroupDeployment

Uguale a Get-AzManagementGroupDeployment.

Remove-AzResourceGroupDeployment

Uguale a Get-AzManagementGroupDeployment.

Save-AzResourceGroupDeploymentTemplate

Uguale a Get-AzManagementGroupDeployment.

Stop-AzResourceGroupDeployment

Uguale a Get-AzManagementGroupDeployment.

Test-AzResourceGroupDeployment

Uguale a Get-AzManagementGroupDeployment.

Get-AzManagementGroupDeploymentWhatIfResult

Uguale a Get-AzManagementGroupDeployment.

Get-AzTenantDeploymentWhatIfResult

Uguale a Get-AzManagementGroupDeployment.

Az.Sql

Set-AzSqlServerActiveDirectoryAdministrator

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

Prima di

Set-AzSqlServerActiveDirectoryAdministrator -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01' -DisplayName 'DBAs' -IsAzureADOnlyAuthentication

Dopo

Set-AzSqlServerActiveDirectoryAdministrator -ResourceGroupName 'ResourceGroup01' -ServerName 'Server01' -DisplayName 'DBAs'

Az.Synapse

New-AzSynapseSqlPool

Non supporta più il parametro FromBackup, FromRestorePointBackupResourceGroupName, BackupWorkspaceName, BackupSqlPoolName, , BackupSqlPoolObject, BackupResourceIdSourceResourceGroupNameSourceWorkspaceNameSourceSqlPoolNameSourceSqlPoolObjectSourceResourceId, RestorePointe non è stato trovato alcun alias per il nome del parametro originale.

Prima di

New-AzSynapseSqlPool -FromBackup -WorkspaceName ContosoWorkspace -Name ContosoSqlPool -BackupWorkspaceName ContosoWorkspace -BackupSqlPoolName ExistingContosoSqlPool

Dopo

PS C:\> New-AzSynapseSqlPool -WorkspaceName ContosoWorkspace -Name ContosoSqlPool -PerformanceLevel DW200c

Update-AzSynapseSqlPool

Non supporta più il parametro Suspend, Resumee non è stato trovato alcun alias per il nome del parametro originale.

Az.Network

Approve-AzPrivateEndpointConnection

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

Prima di

Approve-AzPrivateEndpointConnection -ResourceGroupName xxx -ServiceName xxx -Name xxx -PrivateLinkResourceType 'Microsoft.Network/privateLinkServices' -Description xxx

Dopo

Approve-AzPrivateEndpointConnection -ResourceGroupName xxx -ServiceName xxx -Name xxx -Description xxx

Deny-AzPrivateEndpointConnection

Uguale a Approve-AzPrivateEndpointConnection.

Get-AzPrivateEndpointConnection

Uguale a Approve-AzPrivateEndpointConnection.

Remove-AzPrivateEndpointConnection

Uguale a Approve-AzPrivateEndpointConnection.

Set-AzPrivateEndpointConnection

Uguale a Approve-AzPrivateEndpointConnection.

New-AzNetworkWatcherConnectionMonitorEndpointObject

Non supporta più il parametro FilterType, FilterIteme non è stato trovato alcun alias per il nome del parametro originale.

Prima di

$MySrcResourceId1 = '/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myresourceGroup/providers/Microsoft.OperationalInsights/workspaces/myworkspace'
$SrcEndpointFilterItem1 =New-AzNetworkWatcherConnectionMonitorEndpointFilterItemObject -Type 'AgentAddress' -Address 'WIN-P0HGNDO2S1B'
$SourceEndpointObject1 = New-AzNetworkWatcherConnectionMonitorEndPointObject -Name 'workspaceEndpoint' -ResourceId $MySrcResourceId1 -FilterType Include -FilterItem $SrcEndpointFilterItem1

Dopo

MySrcResourceId1 = '/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/myresourceGroup/providers/Microsoft.OperationalInsights/workspaces/myworkspace'
$SourceEndpointObject1 = New-AzNetworkWatcherConnectionMonitorEndPointObject -Name 'workspaceEndpoint' -ResourceId $MySrcResourceId1