Migreringsguide för Az 2.0.0

Artikel
01/15/2025

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

Innehållsförteckning

Modulförä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 kapsla in 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

Cmdlet Set-AzVMBootDiagnostic har tagit bort alias till Set-AzVMBootDiagnostics

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.
En ny Set-AzHDInsightGatewayCredential-cmdlet har lagts till. 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 förändring enligt ändringspolicyn, kan det kräva vissa ändringar i koden som använder metoderna i Storage .Net SDK för att interagera med de objekt som returneras från dessa cmdlets.

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 brytande förändring, kommer du märka skillnader i utdata i Sku.Name-egenskapen för lagringskonton som returneras från New/Get/Set-AzStorageAccount. Förändringarna är följande. (Efter ändringen är utdata och indata SkuName i linje med varandra.)
- "StandardLRS" –> "Standard_LRS";
- "StandardGRS" –> "Standard_GRS";
- "StandardRAGRS" –> "Standard_RAGRS";
- "StandardZRS" –> "Standard_ZRS";
- "PremiumLRS" –> "Premium_LRS";

Standardbeteendet för tjänsten när du skapar ett lagringskonto utan att ange en typ har ändrats. När ett lagringskonto skapades utan att någon Kind angetts i tidigare versioner, användes lagringskontots typ av 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