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.

• Guida alla migrazione per Az 5.0.0
  • Az.Aks
    • New-AzAksCluster
    • Set-AzAksCluster
  • Az.ContainerRegistry
    • New-AzContainerRegistry
  • az.functions
    • Get-AzFunctionApp
    • New-AzFunctionApp
  • Az.KeyVault
    • New-AzKeyVault
    • Update-AzKeyVault
    • Get-AzKeyVaultSecret
  • Az.ManagedServices
    • Get-AzManagedServicesDefinition
    • New-AzManagedServicesAssignment
    • Remove-AzManagedServicesAssignment
    • Remove-AzManagedServicesDefinition
  • Az.ResourceManager
    • Get-AzManagementGroupDeployment
    • Get-AzManagementGroupDeploymentOperation
    • Get-AzDeployment
    • Get-AzDeploymentOperation
    • Get-AzDeploymentWhatIfResult
    • Get-AzTenantDeployment
    • Get-AzTenantDeploymentOperation
    • New-AzManagementGroupDeployment
    • New-AzDeployment
    • New-AzTenantDeployment
    • remove-AzManagementGroupDeployment
    • Remove-AzDeployment
    • remove-AzTenantDeployment
    • save-AzManagementGroupDeploymentTemplate
    • Save-AzDeploymentTemplate
    • Save-AzTenantDeploymentTemplate
    • stop-AzManagementGroupDeployment
    • Stop-AzDeployment
    • stop-AzTenantDeployment
    • Test-AzManagementGroupDeployment
    • Test-AzDeployment
    • test-AzTenantDeployment
    • Get-AzResourceGroupDeployment
    • Get-AzResourceGroupDeploymentOperation
    • Get-AzResourceGroupDeploymentWhatIfResult
    • New-AzResourceGroupDeployment
    • Remove-AzResourceGroupDeployment
    • save-AzResourceGroupDeploymentTemplate
    • stop-AzResourceGroupDeployment
    • test-AzResourceGroupDeployment
    • Get-AzManagementGroupDeploymentWhatIfResult
    • Get-AzTenantDeploymentWhatIfResult
  • Az.Sql
    • set-AzSqlServerActiveDirectoryAdministrator
  • Az.Synapse
    • New-AzSynapseSqlPool
    • Update-AzSynapseSqlPool
  • Az.Network
    • Approve-AzPrivateEndpointConnection
    • Deny-AzPrivateEndpointConnection
    • Get-AzPrivateEndpointConnection
    • Remove-AzPrivateEndpointConnection
    • set-AzPrivateEndpointConnection
    • New-AzNetworkWatcherConnectionMonitorEndpointObject

Az.Aks

New-AzAksCluster

• Non supporta più il parametro NodeOsType e non è stato trovato alcun alias per il nome del parametro originale, verrà 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

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 il Registro Container classico.

Az.Functions

Get-AzFunctionApp

Rimosso il parametro switch IncludeSlot da tutti i set di parametri di Get-AzFunctionApptranne che da uno. Il cmdlet supporta ora il recupero degli slot di distribuzione nei risultati quando viene specificato -IncludeSlot. 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 di *Application Insights* quando viene specificata questa opzione.
• È stato rimosso il supporto per creare app di funzione PowerShell 6.2 poiché PowerShell 6.2 ha raggiunto la fine del suo ciclo di vita. 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 parametro RuntimeVersion non è specificato.
• Modificata la versione di runtime predefinita nella versione 3 delle Funzioni su Windows e Linux per le app di funzione Node da 10 a 12 quando il parametro RuntimeVersion non è specificato. Tuttavia, gli utenti possono comunque creare app per le funzioni node 10 specificando -Runtime Node e -RuntimeVersion 10. È stata modificata la versione di runtime predefinita nella versione 3 delle Funzioni su Linux per le app di funzioni Python da 3.7 a 3.8, quando il parametro RuntimeVersion non è specificato. Tuttavia, gli utenti possono comunque creare app per le funzioni 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 di eliminazione temporanea è deprecata in Az.KeyVault 3.0.0. Leggi di più

Update-AzKeyVault

Non supporta più il parametro EnableSoftDelete, SoftDeleteRetentionInDayse 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 di eliminazione soft è obsoleta in Az.KeyVault 3.0.0. Leggi di più

Get-AzKeyVaultSecret

La proprietà SecretValueText di tipo Microsoft.Azure.Commands.KeyVault.Models.PSKeyVaultSecret è stata rimossa. Applicare un -AsPlainText alla chiamata per ottenere il segreto di testo normale oppure usare $secret.SecretValue di 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ù il parametro RegistrationDefinitionName, RegistrationDefinitionResourceIde 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ù il parametro Id, ResourceIde 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ù il parametro Id, ResourceIde 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

Dopo

Get-AzManagementGroupDeployment -ManagementGroupId xxx -Name xxx

Get-AzManagementGroupDeploymentOperation

Lo stesso per Get-AzManagementGroupDeployment.

Get-AzDeployment

Lo stesso vale per Get-AzManagementGroupDeployment.

Get-AzDeploymentOperation

Stesso per Get-AzManagementGroupDeployment.

Get-AzDeploymentWhatIfResult

Uguale a Get-AzManagementGroupDeployment.

Get-AzTenantDeployment

Uguale a Get-AzManagementGroupDeployment.

Get-AzTenantDeploymentOperation

È uguale a Get-AzManagementGroupDeployment.

New-AzManagementGroupDeployment

Lo stesso vale per Get-AzManagementGroupDeployment.

New-AzDeployment

Lo stesso vale per Get-AzManagementGroupDeployment.

New-AzTenantDeployment

Lo stesso con Get-AzManagementGroupDeployment.

Remove-AzManagementGroupDeployment

Stesso con Get-AzManagementGroupDeployment.

Remove-AzDeployment

Stesso per Get-AzManagementGroupDeployment.

Remove-AzTenantDeployment

Lo stesso con Get-AzManagementGroupDeployment.

Save-AzManagementGroupDeploymentTemplate

Lo stesso con Get-AzManagementGroupDeployment.

Save-AzDeploymentTemplate

Lo stesso di Get-AzManagementGroupDeployment.

Save-AzTenantDeploymentTemplate

Uguale a Get-AzManagementGroupDeployment.

Stop-AzManagementGroupDeployment

Lo stesso con Get-AzManagementGroupDeployment.

Stop-AzDeployment

Lo stesso con Get-AzManagementGroupDeployment.

Stop-AzTenantDeployment

Uguale a Get-AzManagementGroupDeployment.

Test-AzManagementGroupDeployment

Lo stesso vale per Get-AzManagementGroupDeployment.

Test-AzDeployment

Lo stesso vale per Get-AzManagementGroupDeployment.

Test-AzTenantDeployment

Lo stesso con Get-AzManagementGroupDeployment.

Get-AzResourceGroupDeployment

Lo stesso vale per Get-AzManagementGroupDeployment.

Get-AzResourceGroupDeploymentOperation

Lo stesso con Get-AzManagementGroupDeployment.

Get-AzResourceGroupDeploymentWhatIfResult

Lo stesso di Get-AzManagementGroupDeployment.

New-AzResourceGroupDeployment

Lo stesso vale per 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

Lo stesso con 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

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, FromRestorePoint, BackupResourceGroupName, BackupWorkspaceName, BackupSqlPoolName, BackupSqlPoolObject, BackupResourceId, SourceResourceGroupName, SourceWorkspaceName, SourceSqlPoolName, SourceSqlPoolObject, SourceResourceId, RestorePointe non è stato trovato alcun alias per il nome del parametro originale.

Prima

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

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

Stesso per Approve-AzPrivateEndpointConnection.

Get-AzPrivateEndpointConnection

Uguale a Approve-AzPrivateEndpointConnection.

Remove-AzPrivateEndpointConnection

Lo stesso per Approve-AzPrivateEndpointConnection.

Set-AzPrivateEndpointConnection

Lo stesso vale per Approve-AzPrivateEndpointConnection.

New-AzNetworkWatcherConnectionMonitorEndpointObject

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

Prima

$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