Migreringsguide för Az 5.0.0

I det här dokumentet beskrivs ändringarna mellan 4.0.0 och 5.0.0-versionen av Az.

• Migreringsguide för 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

• Parametern stöds inte längre NodeOsType och det hittades inget alias för det ursprungliga parameternamnet, det kommer alltid att Linux finnas.
• Det finns inte längre stöd för ClientIdAndSecret ServicePrincipalIdAndSecret parameteraliaset.
• Standardvärdet ändras NodeVmSetType från AvailabilitySet till VirtualMachineScaleSets .
• Standardvärdet ändras NetworkPlugin från none till azure .

Före

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

Efter

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

Set-AzAksCluster

Det finns inte längre stöd för ClientIdAndSecret ServicePrincipalIdAndSecret parameteraliaset.

Före

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

Efter

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

Az.ContainerRegistry

New-AzContainerRegistry

Parametern stöds inte längre StorageAccountName och det hittades inget alias för det ursprungliga parameternamnet.

Före

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

Efter

Classic var inaktuellt och StorageAccountName togs bort eftersom det bara fungerar med Classic Container Registry.

Az.Functions

Get-AzFunctionApp

Tog IncludeSlot bort växelparameter från alla utom en parameteruppsättning med Get-AzFunctionApp . Cmdleten har nu stöd för att hämta distributionsplatser i resultatet när -IncludeSlot anges. Den här funktionen var trasig i den tidigare cmdlet-versionen. Det här är dock åtgärdat nu.

New-AzFunctionApp

• Åtgärdat -DisableApplicationInsights så att inga projekt med New-AzFunctionApp programinsikter skapas när det här alternativet har angetts.
• Borttaget stöd för att skapa PowerShell 6.2-funktionsappar eftersom PowerShell 6.2 är EOL. De aktuella råden för kunder är att skapa PowerShell 7.0-funktionsappar i stället.
• Ändrade standardkörningsversionen i Funktioner version 3 på Windows för PowerShell-funktionsappar från 6.2 till 7.0 när RuntimeVersion parametern inte har angetts.
• Ändrade standardkörningsversionen i Funktioner version 3 på Windows och Linux för nodfunktionsappar från 10 till 12 RuntimeVersion när parametern inte anges. Användarna kan dock fortfarande skapa nod 10-funktionsappar genom att ange -Runtime Node och -RuntimeVersion 10 . Ändrade standardkörningsversionen i Funktioner version 3 på Linux för Python-funktionsappar från 3.7 till 3.8 RuntimeVersion när parametern inte anges. Användarna kan dock fortfarande skapa Python 3.7-funktionsappar genom att ange -Runtime Python och -RuntimeVersion 3.7 .

Före

# 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

Efter

# 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

Parametern stöds inte längre DisableSoftDelete och det hittades inget alias för det ursprungliga parameternamnet.

Före

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

Efter

Möjligheten att uppdatera mjuk borttagning-inställningen är inaktuell i Az.KeyVault 3.0.0. Läs mer

Update-AzKeyVault

Parametern stöds inte längre EnableSoftDelete SoftDeleteRetentionInDays och det hittades inget alias för det ursprungliga parameternamnet.

Före

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

Efter

Möjligheten att uppdatera mjuk borttagning-inställningen är inaktuell i Az.KeyVault 3.0.0. Läs mer

Get-AzKeyVaultSecret

Egenskapen SecretValueText för typen Microsoft.Azure.Commands.KeyVault.Models.PSKeyVaultSecret har tagits bort. Använd antingen -AsPlainText en för samtalet för att få en oformaterad texthemlighet eller använd av typen i $secret.SecretValue SecureString skriptet.

Före

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

Efter

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

Az.ManagedServices

Get-AzManagedServicesDefinition

Parametern stöds inte längre ResourceId och det hittades inget alias för det ursprungliga parameternamnet.

Före

Get-AzManagedServicesDefinition -ResourceId xxx

Efter

Get-AzManagedServicesDefinition -Id xxx

New-AzManagedServicesAssignment

Parametern stöds inte längre RegistrationDefinitionName RegistrationDefinitionResourceId och det hittades inget alias för det ursprungliga parameternamnet.

Före

New-AzManagedServicesAssignment -RegistrationDefinitionName xxx -Scope xxx

Efter

New-AzManagedServicesAssignment -Scope xxx -RegistrationDefinition xxx

Remove-AzManagedServicesAssignment

Parametern stöds inte längre Id ResourceId och det hittades inget alias för det ursprungliga parameternamnet.

Före

Remove-AzManagedServicesAssignment -ResourceId xxx

Efter

Get-AzManagedServicesAssignment -Scope xxx | Remove-AzManagedServicesAssignment

Remove-AzManagedServicesDefinition

Parametern stöds inte längre Id ResourceId och det hittades inget alias för det ursprungliga parameternamnet.

Före

Remove-AzManagedServicesDefinition -ResourceId xxx

Efter

Get-AzManagedServicesDefinition -Scope xxx | Remove-AzManagedServicesDefinition

Az.ResourceManager

Get-AzManagementGroupDeployment

Parametern stöds inte längre ApiVersion och det hittades inget alias för det ursprungliga parameternamnet.

Före

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

Efter

Get-AzManagementGroupDeployment -ManagementGroupId xxx -Name xxx

Get-AzManagementGroupDeploymentOperation

Samma som med Get-AzManagementGroupDeployment .

Get-AzDeployment

Samma som med Get-AzManagementGroupDeployment .

Get-AzDeploymentOperation

Samma som med Get-AzManagementGroupDeployment .

Get-AzDeploymentWhatIfResult

Samma som med Get-AzManagementGroupDeployment .

Get-AzTenantDeployment

Samma som med Get-AzManagementGroupDeployment .

Get-AzTenantDeploymentOperation

Samma som med Get-AzManagementGroupDeployment .

New-AzManagementGroupDeployment

Samma som med Get-AzManagementGroupDeployment .

New-AzDeployment

Samma som med Get-AzManagementGroupDeployment .

New-AzTenantDeployment

Samma som med Get-AzManagementGroupDeployment .

Remove-AzManagementGroupDeployment

Samma som med Get-AzManagementGroupDeployment .

Remove-AzDeployment

Samma som med Get-AzManagementGroupDeployment .

Remove-AzTenantDeployment

Samma som med Get-AzManagementGroupDeployment .

Save-AzManagementGroupDeploymentTemplate

Samma som med Get-AzManagementGroupDeployment .

Save-AzDeploymentTemplate

Samma som med Get-AzManagementGroupDeployment .

Save-AzTenantDeploymentTemplate

Samma som med Get-AzManagementGroupDeployment .

Stop-AzManagementGroupDeployment

Samma som med Get-AzManagementGroupDeployment .

Stop-AzDeployment

Samma som med Get-AzManagementGroupDeployment .

Stop-AzTenantDeployment

Samma som med Get-AzManagementGroupDeployment .

Test-AzManagementGroupDeployment

Samma som med Get-AzManagementGroupDeployment .

Test-AzDeployment

Samma som med Get-AzManagementGroupDeployment .

Test-AzTenantDeployment

Samma som med Get-AzManagementGroupDeployment .

Get-AzResourceGroupDeployment

Samma som med Get-AzManagementGroupDeployment .

Get-AzResourceGroupDeploymentOperation

Samma som med Get-AzManagementGroupDeployment .

Get-AzResourceGroupDeploymentWhatIfResult

Samma som med Get-AzManagementGroupDeployment .

New-AzResourceGroupDeployment

Samma som med Get-AzManagementGroupDeployment .

Remove-AzResourceGroupDeployment

Samma som med Get-AzManagementGroupDeployment .

Save-AzResourceGroupDeploymentTemplate

Samma som med Get-AzManagementGroupDeployment .

Stop-AzResourceGroupDeployment

Samma som med Get-AzManagementGroupDeployment .

Test-AzResourceGroupDeployment

Samma som med Get-AzManagementGroupDeployment .

Get-AzManagementGroupDeploymentWhatIfResult

Samma som med Get-AzManagementGroupDeployment .

Get-AzTenantDeploymentWhatIfResult

Samma som med Get-AzManagementGroupDeployment .

Az.Sql

Set-AzSqlServerActiveDirectoryAdministrator

Parametern stöds inte längre IsAzureADOnlyAuthentication och det hittades inget alias för det ursprungliga parameternamnet.

Före

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

Efter

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

Az.Synapse

New-AzSynapseSqlPool

Du har inte längre stöd FromBackup FromRestorePoint för parametern , , , , , , , , , och inga BackupResourceGroupName BackupWorkspaceName alias BackupSqlPoolName BackupSqlPoolObject BackupResourceId SourceResourceGroupName SourceWorkspaceName SourceSqlPoolName SourceSqlPoolObject SourceResourceId RestorePoint hittades för det ursprungliga parameternamnet.

Före

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

Efter

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

Update-AzSynapseSqlPool

Parametern stöds inte längre Suspend Resume och det hittades inget alias för det ursprungliga parameternamnet.

Az.Network

Approve-AzPrivateEndpointConnection

Parametern stöds inte längre PrivateLinkResourceType och det hittades inget alias för det ursprungliga parameternamnet.

Före

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

Efter

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

Deny-AzPrivateEndpointConnection

Samma som med Approve-AzPrivateEndpointConnection .

Get-AzPrivateEndpointConnection

Samma som med Approve-AzPrivateEndpointConnection .

Remove-AzPrivateEndpointConnection

Samma som med Approve-AzPrivateEndpointConnection .

Set-AzPrivateEndpointConnection

Samma som med Approve-AzPrivateEndpointConnection .

New-AzNetworkWatcherConnectionMonitorEndpointObject

Parametern stöds inte längre FilterType FilterItem och det hittades inget alias för det ursprungliga parameternamnet.

Före

$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

Efter

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