Migreringsguide för Az 2.0.0

Artikel
03/05/2025

Det här dokumentet beskriver ändringarna mellan versionerna 1.0.0 och 2.0.0 av Az

Innehållsförteckning

Moduländringar som bryter

Modulbrytande ändringar

Az.Compute

Managed Parameter har tagits bort från cmdletarna New-AzAvailabilitySet och Update-AzAvailabilitySet till förmån för att använda Sku = Aligned

Före
```
Update-AzAvailabilitySet -Managed
```
Efter
```
Update-AzAvailabilitySet -Sku Aligned
```
För konsekvens tog Image parametern bort från parameteruppsättningarna ByName och ByResourceId i Update-AzImage

Före

Observera att koden nedan fungerar, men att det införda ImageName inte används, så att ta bort den här parametern har ingen funktionspåverkan.
```
Update-AzImage -ResourceGroupName $Rg -ImageName $Name -Image $Image -Tag $tags

Update-AzImage -ResourceId $Id -Image $Image -Tag $tags
```
Efter
```
Update-AzImage -ResourceGroupName $Rg -ImageName $Name -Tag $tags

Update-AzImage -ResourceId $Id -Tag $tags
```
För konsekvens tog Name parametern bort från parameteruppsättningarna ByObject och ByResourceId i Restart-AzVM

Före

Observera att koden nedan fungerar, men att det skickade namnet inte används, så att ta bort den här parametern har ingen funktionspåverkan.
```
Restart-AzVM -InputObject $VM -Name $Name

Restart-AzVM -ResourceId $Id -Name $Name
```
Efter
```
Restart-AzVM -InputObject $VM

Restart-AzVM -ResourceId $Id
```
För konsekvens tog Name parametern bort från parameteruppsättningarna ByObject och ByResourceId i Start-AzVM

Före

Observera att koden nedan fungerar, men att det skickade namnet inte används, så att ta bort den här parametern har ingen funktionspåverkan.
```
Start-AzVM -InputObject $VM -Name $Name

Start-AzVM -ResourceId $Id -Name $Name
```
Efter
```
Start-AzVM -InputObject $VM

Start-AzVM -ResourceId $Id
```
För konsekvens tog Name parametern bort från parameteruppsättningarna ByObject och ByResourceId i Stop-AzVM

Före

Observera att koden nedan fungerar, men att det skickade namnet inte används, så att ta bort den här parametern har ingen funktionspåverkan.
```
Stop-AzVM -InputObject $VM -Name $Name

Stop-AzVM -ResourceId $Id -Name $Name
```
Efter
```
Stop-AzVM -InputObject $VM

Stop-AzVM -ResourceId $Id
```
För konsekvens tog Name parametern bort från parameteruppsättningarna ByObject och ByResourceId i Remove-AzVM

Före

Observera att koden nedan fungerar, men att det skickade namnet inte används, så att ta bort den här parametern har ingen funktionspåverkan.
```
Remove-AzVM -InputObject $VM -Name $Name

Remove-AzVM -ResourceId $Id -Name $Name
```
Efter
```
Remove-AzVM -InputObject $VM

Remove-AzVM -ResourceId $Id
```
För konsekvens tog Name parametern bort från parameteruppsättningarna ByObject och ByResourceId i Set-AzVM

Före

Observera att koden nedan fungerar, men att det skickade namnet inte används, så att ta bort den här parametern har ingen funktionspåverkan.
```
Set-AzVM -InputObject $VM -Name $Name ...

Set-AzVM -ResourceId $Id -Name $Name ...
```
Efter
```
Set-AzVM -InputObject $VM ...

Set-AzVM -ResourceId $Id ...
```
För konsekvens tog Name parametern bort från parameteruppsättningarna ByObject och ByResourceId i Save-AzVMImage

Före

Observera att koden nedan fungerar, men att det skickade namnet inte används, så att ta bort den här parametern har ingen funktionspåverkan.
```
Save-AzVMImage -InputObject $VM -Name $Name ...

Save-AzVMImage -ResourceId $Id -Name $Name ...
```
Efter
```
Save-AzVMImage -InputObject $VM ...

Save-AzVMImage -ResourceId $Id ...
```

Egenskapen ProtectionPolicy har lagts till för att inkapsla egenskapen ProtectFromScaleIn i PSVirtualMachineScaleSetVM

Före

$vmss = Get-AzVMssVM ...
$vmss.ProtectFromScaleIn = $true

$vmss = Update-AzVMssVM ...
$vmss.ProtectFromScaleIn = $true

$vmss = Remove-AzVMssVMDataDisk ...
$vmss.ProtectFromScaleIn = $true

Efter

$vmss = Get-AzVMssVM ...
$vmss.ProtectionPolicy.ProtectFromScaleIn = $true

$vmss = Update-AzVMssVM ...
$vmss.ProtectionPolicy.ProtectFromScaleIn = $true

$vmss = Remove-AzVMssVMDataDisk ...
$vmss.ProtectionPolicy.ProtectFromScaleIn = $true

EncryptionSettingsCollection-egenskapen har lagts till för att omsluta egenskapen EncryptionSettings i PSDisk

Före

$disk = New-AzDisk ... | Set-AzDiskDiskEncrytionKey ...
$disk.EncryptionSettings

$disk = New-AzDisk ... | Set-AzDiskKeyEncrytionKey ...
$disk.EncryptionSettings

$update = New-AzDiskUpdateConfig | Set-AzDiskUpdateDiskEncryptionKey ...
$update.EncryptionSettings

$update = New-AzDiskUpdateConfig | Set-AzDiskUpdateKeyEncryptionKey ...
$update.EncryptionSettings

Efter

$disk = New-AzDisk ... | Set-AzDiskDiskEncrytionKey ...
$disk.EncryptionSettingsCollection.EncryptionSettings

$disk = New-AzDisk ... | Set-AzDiskKeyEncrytionKey ...
$disk.EncryptionSettingsCollection.EncryptionSettings

$update = New-AzDiskUpdateConfig | Set-AzDiskUpdateDiskEncryptionKey ...
$update.EncryptionSettingsCollection.EncryptionSettings

$update = New-AzDiskUpdateConfig | Set-AzDiskUpdateKeyEncryptionKey ...
$update.EncryptionSettingsCollection.EncryptionSettings

EncryptionSettingsCollection-egenskapen har lagts till för att omsluta egenskapen EncryptionSettings i PSSnapshot

Före

$snap = New-AzSnapshotConfig ... | Set-AzSnapshotDiskEncryptionKey ...
$snap.EncryptionSettings

$snap = New-AzSnapshotConfig ... | Set-AzSnapshotKeyEncryptionKey ...
$snap.EncryptionSettings

$update = New-AzSnapshotUpdateConfig ... | Set-AzSnapshotUpdateDiskEncryptionKey ...
$update.EncryptionSettings

$update = New-AzSnapshotUpdateConfig ... | Set-AzSnapshotUpdateKeyEncryptionKey ...
$update.EncryptionSettings

Efter

$snap = New-AzSnapshotConfig ... | Set-AzSnapshotDiskEncryptionKey ...
$snap.EncryptionSettingsCollection.EncryptionSettings

$snap = New-AzSnapshotConfig ... | Set-AzSnapshotKeyEncryptionKey ...
$snap.EncryptionSettingsCollection.EncryptionSettings

$update = New-AzSnapshotUpdateConfig ... | Set-AzSnapshotUpdateDiskEncryptionKey ...
$update.EncryptionSettingsCollection.EncryptionSettings

$update = New-AzSnapshotUpdateConfig ... | Set-AzSnapshotUpdateKeyEncryptionKey ...
$update.EncryptionSettingsCollection.EncryptionSettings

VirtualMachineProfile-egenskapen har tagits bort från PSVirtualMachineScaleSet

Före

$vmss = New-AzVMSSConfig ...
$vmss.VirtualMachineProfile.AdditionalCapabilities.UltraSSDEnabled = $true

Efter

$vmss = New-AzVMSSConfig ...
$vmss.AdditionalCapabilities.UltraSSDEnabled = $true

Aliaset för Set-AzVMBootDiagnostics har tagits bort av cmdlet Set-AzVMBootDiagnostic.

Före

Använda inaktuellt alias
```
Set-AzVMBootDiagnostics
```
Efter
```
Set-AzVMBootDIagnostic
```
Cmdlet Export-AzLogAnalyticThrottledRequest tog bort alias till Export-AzLogAnalyticThrottledRequests

Före

Använda föråldrad alias
```
Export-AzLogAnalyticThrottledRequests
```
Efter
```
Export-AzLogAnalyticThrottledRequest
```

Az.HDInsight

Tog bort cmdletarna Grant-AzHDInsightHttpServicesAccess och Revoke-AzHDInsightHttpServicesAccess. Dessa är inte längre nödvändiga eftersom HTTP-åtkomst alltid är aktiverad i alla HDInsight-kluster.
Lade till ett nytt Set-AzHDInsightGatewayCredential cmdlet. Använd den här cmdleten för att ändra http-användarnamnet och lösenordet för gatewayen (ersätter Grant-AzHDInsightHttpServicesAccess).
Uppdaterade cmdleten Get-AzHDInsightJobOutput för att stödja detaljerad rollbaserad åtkomst till lagringsnyckeln.
- Användare med HDInsight-klusteroperator-, deltagar- eller ägarroller påverkas inte.
- Användare med rollen Läsare måste uttryckligen ange DefaultStorageAccountKey parameter.

Mer information om dessa rollbaserade åtkomständringar finns i aka.ms/hdi-config-update

Före

Grant-AzHDInsightHttpServicesAccess -ClusterName $cluster -HttpCredential $credential

Efter

Set-AzHDInsightGatewayCredential -ClusterName $cluster -HttpCredential $credential

Användare med endast läsarroll för cmdlet-Get-AzHDInsightJobOutput

Före

Get-AzHDInsightJobOutput  -ClusterName $clusterName -JobId $jobId

Efter

Get-AzHDInsightJobOutput  -ClusterName $clusterName -JobId $jobId -DefaultStorageAccountKey $storageAccountKey

Az.Storage

Namnrymder för typer som returneras från cmdletarna Blob, Queue och File har ändrat namnområdet från Microsoft.WindowsAzure.Storage till Microsoft.Azure.Storage. Även om detta tekniskt sett inte är en icke-bakåtkompatibel ändring enligt principen för icke-bakåtkompatibla ändringar, kan det kräva vissa ändringar i koden som använder metoderna från Storage .Net SDK för att interagera med de objekt som returneras från dessa cmdletar.

Exempel 1: Lägg till ett meddelande i en kö (ändra CloudQueueMessage-objektnamnområdet)

Före:

$queue = Get-AzStorageQueue –Name $queueName –Context $ctx
$queueMessage = New-Object -TypeName "Microsoft.WindowsAzure.Storage.Queue.CloudQueueMessage,$($queue.CloudQueue.GetType().Assembly.FullName)" -ArgumentList "This is message 1"
$queue.CloudQueue.AddMessageAsync($QueueMessage)

Efter:

$queue = Get-AzStorageQueue –Name $queueName –Context $ctx
$queueMessage = New-Object -TypeName "Microsoft.Azure.Storage.Queue.CloudQueueMessage,$($queue.CloudQueue.GetType().Assembly.FullName)"  -ArgumentList "This is message 1"
$queue.CloudQueue.AddMessageAsync($QueueMessage)

Exempel 2: Hämta blob-/filattribut med AccessCondition (ändra Namnområde för AccessCondition-objekt)

Före:

$accessCondition= New-Object Microsoft.WindowsAzure.Storage.AccessCondition

$blob = Get-AzureStorageBlob -Container $containerName -Blob $blobName
$blob.ICloudBlob.FetchAttributes($accessCondition)

$file = Get-AzureStorageFile -ShareName $shareName -Path $filepath
$file.FetchAttributes($accessCondition)

Efter:

$accessCondition= New-Object Microsoft.Azure.Storage.AccessCondition

$blob = Get-AzureStorageBlob -Container $containerName -Blob $blobName
$blob.ICloudBlob.FetchAttributes($accessCondition)

$file = Get-AzureStorageFile -ShareName $shareName -Path $filepath
$file.FetchAttributes($accessCondition)

Även om det tekniskt sett inte är en skapande ändring ser du utdataskillnader i egenskapen Sku.Name för lagringskonton som returneras när ändringarna från New/Get/Set-AzStorageAccount är följande. (Efter ändringen är utgående och ingående SkuName anpassade.)
- "StandardLRS" –> "Standard_LRS";
- "StandardGRS" –> "Standard_GRS";
- "StandardRAGRS" –> "Standard_RAGRS";
- "StandardZRS" –> "Standard_ZRS";
- "PremiumLRS" –> "Premium_LRS";

Standardbeteendet för tjänsten har ändrats vid skapande av ett lagringskonto utan att ange en typ. I tidigare versioner, när ett lagringskonto skapades utan att något Kind angavs, användes lagringskontotypen Storage. I den nya versionen är StorageV2 standardvärdet Kind. Om du behöver skapa ett V1 Storage-konto med Kind 'Storage' lägger du till parametern "-Kind Storage"

Exempel: Skapa ett lagringskonto (ändring av standardtyp)

Före:

PS c:\> New-AzStorageAccount -ResourceGroupName groupname -Name accountname -SkuName Standard_LRS -Location "westus"

StorageAccountName ResourceGroupName Location SkuName     Kind      AccessTier CreationTime          ProvisioningState EnableHttpsTrafficOnly
------------------ ----------------- -------- -------     ----      ---------- ------------          ----------------- ----------------------
accountname        groupname         westus   StandardLRS Storage   Hot        4/17/2018 10:34:32 AM Succeeded         False

Efter:

PS c:\> New-AzStorageAccount -ResourceGroupName groupname -Name accountname -SkuName Standard_LRS -Location "westus"

StorageAccountName ResourceGroupName Location SkuName      Kind      AccessTier CreationTime          ProvisioningState EnableHttpsTrafficOnly
------------------ ----------------- -------- -------      ----      ----------  ------------          ----------------- ----------------------
accountname        groupname         westus   Standard_LRS StorageV2 Hot        4/17/2018 10:34:32 AM Succeeded         False

Dela via

Migreringsguide för Az 2.0.0

Innehållsförteckning

Modulbrytande ändringar

Az.Compute

Före

Efter

Före

Efter

Före

Efter

Före

Efter

Före

Efter

Före

Efter

Före

Efter

Före

Efter

Före

Efter

Före

Efter

Före

Efter

Före

Efter

Före

Efter

Före

Efter

Az.HDInsight

Före

Efter

Användare med endast läsarroll för cmdlet-Get-AzHDInsightJobOutput

Före

Efter

Az.Storage

Exempel 1: Lägg till ett meddelande i en kö (ändra CloudQueueMessage-objektnamnområdet)

Exempel 2: Hämta blob-/filattribut med AccessCondition (ändra Namnområde för AccessCondition-objekt)

Exempel: Skapa ett lagringskonto (ändring av standardtyp)

Ytterligare resurser