Migreringsguide för Az 2.0.0

Artikel
11/13/2024

I det här dokumentet beskriver vi ändringarna mellan Az-versionerna 1.0.0 och 2.0.0

Innehållsförteckning

Icke-bakåtkompatibla ändringar

Icke-bakåtkompatibla ändringar

Az.Compute

Tog bort parametern Managed från New-AzAvailabilitySet och cmdletarna Update-AzAvailabilitySet för att använda Sku = Aligned

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

Före

Obs! Nedanstående kod fungerar men det inskickade ImageName-namnet används inte. Det ger ingen funktionell påverkan att ta bort den här parametern.
```
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
```
Tog för konsekvens bort parametern Name från parameteruppsättningarna ByObject and ByResourceId i Restart-AzVM

Före

Obs! Nedanstående kod fungerar men det inskickade namnet används inte. Det ger ingen funktionell påverkan att ta bort den här parametern.
```
Restart-AzVM -InputObject $VM -Name $Name

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

Restart-AzVM -ResourceId $Id
```
Tog för konsekvens bort parametern Name från parameteruppsättningarna ByObject and ByResourceId i Start-AzVM

Före

Obs! Nedanstående kod fungerar men det inskickade namnet används inte. Det ger ingen funktionell påverkan att ta bort den här parametern.
```
Start-AzVM -InputObject $VM -Name $Name

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

Start-AzVM -ResourceId $Id
```
Tog för konsekvens bort parametern Name från parameteruppsättningarna ByObject and ByResourceId i Stop-AzVM

Före

Obs! Nedanstående kod fungerar men det inskickade namnet används inte. Det ger ingen funktionell påverkan att ta bort den här parametern.
```
Stop-AzVM -InputObject $VM -Name $Name

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

Stop-AzVM -ResourceId $Id
```
Tog för konsekvens bort parametern Name från parameteruppsättningarna ByObject and ByResourceId i Remove-AzVM

Före

Obs! Nedanstående kod fungerar men det inskickade namnet används inte. Det ger ingen funktionell påverkan att ta bort den här parametern.
```
Remove-AzVM -InputObject $VM -Name $Name

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

Remove-AzVM -ResourceId $Id
```
Tog för konsekvens bort parametern Name från parameteruppsättningarna ByObject and ByResourceId i Set-AzVM

Före

Obs! Nedanstående kod fungerar men det inskickade namnet används inte. Det ger ingen funktionell påverkan att ta bort den här parametern.
```
Set-AzVM -InputObject $VM -Name $Name ...

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

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

Före

Obs! Nedanstående kod fungerar men det inskickade namnet används inte. Det ger ingen funktionell påverkan att ta bort den här parametern.
```
Save-AzVMImage -InputObject $VM -Name $Name ...

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

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

Lade till ProtectionPolicy-egenskap 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

Lade till egenskapen EncryptionSettingsCollection för att kapsla in 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

Lade till egenskapen EncryptionSettingsCollection för att kapsla in 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

Tog bort egenskapen VirtualMachineProfile från PSVirtualMachineScaleSet

Före

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

Efter

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

Cmdleten Set-AzVMBootDiagnostic tog bort alias till Set-AzVMBootDiagnostics

Före

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

Före

Använda inaktuellt alias
```
Export-AzLogAnalyticThrottledRequests
```
Efter
```
Export-AzLogAnalyticThrottledRequest
```

Az.HDInsight

Tog bort cmdletarna Grant-AzHDInsightHttpServicesAccess och Revoke-AzHDInsightHttpServicesAccess. De här behövs inte längre eftersom HTTP-åtkomst alltid är aktiverat i alla HDInsight-kluster.
Lade till en ny Set-AzHDInsightGatewayCredential-cmdlet. Med den här cmdleten ändrar du HTTP-användarnamnet och lösenordet för nätverksgateway (ersätter Grant-AzHDInsightHttpServicesAccess).
Uppdaterade cmdleten Get-AzHDInsightJobOutput för att ge stöd för detaljerad rollbaserad åtkomst till lagringsnyckeln.
- Användare med rollerna HDInsight-klusteroperator, Deltagare och Ägare påverkas inte.
- Användare med skrivskyddad åtkomst behöver ange parametern DefaultStorageAccountKey uttryckligen.

Mer information om de här ändringarna av den rollbaserade åtkomsten 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 skrivskyddad roll för cmdlet Get-AzHDInsightJobOutput

Före

Get-AzHDInsightJobOutput  -ClusterName $clusterName -JobId $jobId

Efter

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

Az.Storage

Namnområden för typer returnerade från cmdletarna Blob, Queue och File har ändrat sin namnrymd från Microsoft.WindowsAzure.Storage till Microsoft.Azure.Storage. Det kan vara så att en ändring inte tekniskt sett är icke-bakåtkompatibel men att den kräver ändringar i koden som använder metoderna från arkivet .Net SDK för att kunna interagera med objekten som returneras från cmdletarna.

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

Innan:

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

Innan:

$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 icke-bakåtkompatibel ändring ser du utdataskillnader i Sku.Name egenskapen för lagringskonton som returneras från New/Get/Set-AzStorageAccount ändringar är följande. (Efter ändringen justeras utgående och inkommande SkuName.)
- "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 specificera att värdet för Kind har ändrats. När ett lagringskonto i tidigare versioner skapades utan angivet värde för Kind användes lagringskontotypen Storage. I den nya versionen är StorageV2 standardvärdet för Kind. Om du behöver skapa ett V1 Storage-konto med Kind-värde Storage lägger du till parametern -Kind Storage

Exempel: Skapa ett lagringskonto (standardändring av typ)

Innan:

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

Icke-bakåtkompatibla ä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 skrivskyddad roll 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 (standardändring av typ)

Ytterligare resurser