Migreringsguide för Az 2.0.0

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

Innehållsförteckning

Ändringar som påverkar modulen

Ändringar som bryter mot modulen

Az.Compute

Parametern Managed har tagits bort från cmdletarna New-AzAvailabilitySet och Update-AzAvailabilitySet till förmån för användning av Sku = Aligned

före
```
Update-AzAvailabilitySet -Managed
```
Efter
```
Update-AzAvailabilitySet -Sku Aligned
```
För konsekvens tog du bort Image parametern 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 att säkerställa konsekvens togs 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 att säkerställa konsekvens togs 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 att säkerställa konsekvens togs 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 att säkerställa konsekvens togs 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 att säkerställa konsekvens togs 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 att säkerställa konsekvens togs 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

Egenskapen EncryptionSettingsCollection 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

Egenskapen EncryptionSettingsCollection 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

Egenskapen har tagits bort 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 aliaset till Set-AzVMBootDiagnostics

före

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

före

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

Az.HDInsight

Cmdletarna Grant-AzHDInsightHttpServicesAccess och Revoke-AzHDInsightHttpServicesAccess har tagits bort. Dessa är inte längre nödvändiga eftersom HTTP-åtkomst alltid är aktiverad i alla HDInsight-kluster.
Lade till en ny 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).
Cmdleten Get-AzHDInsightJobOutput har uppdaterats för att ge detaljerad rollbaserad åtkomst till lagringsnyckeln.
- Användare med HDInsight-klusteroperator-, deltagar- eller ägarroller påverkas inte.
- Användare med endast rollen Läsare måste uttryckligen ange DefaultStorageAccountKey parametern.

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

Namnrymderna för typer som returneras från blob-, kö- och fil-cmdletar har ändrats från namnområdet Microsoft.WindowsAzure.Storage till Microsoft.Azure.Storage. Även om detta tekniskt inte betraktas som en brytande ändring enligt policyn för brytande ändringar, kan det kräva vissa ändringar i koden som använder metoder från 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 ändring, kommer du att märka skillnader i utdata i egenskapen för Sku.Name hos lagringskonton som returneras från New/Get/Set-AzStorageAccount. Följande ändringar observeras. (Efter ändringen synkroniseras output- och input-SkuName.)
- "StandardLRS" –> "Standard_LRS";
- "StandardGRS" –> "Standard_GRS";
- "StandardRAGRS" –> "Standard_RAGRS";
- "StandardZRS" –> "Standard_ZRS";
- "PremiumLRS" –> "Premium_LRS";

Tjänstens standardbeteende när du skapar ett lagringskonto utan att ange en typ har ändrats. I tidigare versioner, när ett lagringskonto skapades utan angivet Kind , användes lagringskontot Typ av Storage , i den nya versionen StorageV2 är 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

Feedback

Var den här sidan till hjälp?

Last updated on 2026-08-05

Migreringsguide för Az 2.0.0

Innehållsförteckning

Ändringar som bryter mot modulen

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)

Feedback

Ytterligare resurser