Průvodce migrací pro Az 2.0.0

Článek
01/15/2025

Tento dokument popisuje změny mezi verzemi 1.0.0 a 2.0.0 az.

Obsah

Modul, který způsobuje průlomové změny

Změny narušující kompatibilitu modulu

Az.Compute

Odebrání parametru Managed z rutin New-AzAvailabilitySet a Update-AzAvailabilitySet ve prospěch použití Sku = Aligned

Před
```
Update-AzAvailabilitySet -Managed
```
Po
```
Update-AzAvailabilitySet -Sku Aligned
```
Pro konzistenci odebraný parametr Image ze sad parametrů ByName a ByResourceId v Update-AzImage

Před

Všimněte si, že následující kód je funkční, ale předaný ImageName se nepoužívá, takže odebrání tohoto parametru nemá žádný funkční dopad.
```
Update-AzImage -ResourceGroupName $Rg -ImageName $Name -Image $Image -Tag $tags

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

Update-AzImage -ResourceId $Id -Tag $tags
```
Pro konzistenci odebraný parametr Name ze sad parametrů ByObject a ByResourceId v Restart-AzVM

Před

Všimněte si, že následující kód je funkční, ale předaný název se nepoužívá, takže odebrání tohoto parametru nemá žádný funkční dopad.
```
Restart-AzVM -InputObject $VM -Name $Name

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

Restart-AzVM -ResourceId $Id
```
Pro konzistenci odebraný parametr Name ze sad parametrů ByObject a ByResourceId v Start-AzVM

Před

Všimněte si, že následující kód je funkční, ale předaný název se nepoužívá, takže odebrání tohoto parametru nemá žádný funkční dopad.
```
Start-AzVM -InputObject $VM -Name $Name

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

Start-AzVM -ResourceId $Id
```
Pro konzistenci odebraný parametr Name ze sad parametrů ByObject a ByResourceId v Stop-AzVM

Před

Všimněte si, že následující kód je funkční, ale předaný název se nepoužívá, takže odebrání tohoto parametru nemá žádný funkční dopad.
```
Stop-AzVM -InputObject $VM -Name $Name

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

Stop-AzVM -ResourceId $Id
```
Pro konzistenci odebraný parametr Name ze sad parametrů ByObject a ByResourceId v Remove-AzVM

Před

Všimněte si, že následující kód je funkční, ale předaný název se nepoužívá, takže odebrání tohoto parametru nemá žádný funkční dopad.
```
Remove-AzVM -InputObject $VM -Name $Name

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

Remove-AzVM -ResourceId $Id
```
Pro konzistenci odebraný parametr Name ze sad parametrů ByObject a ByResourceId v Set-AzVM

Před

Všimněte si, že následující kód je funkční, ale předaný název se nepoužívá, takže odebrání tohoto parametru nemá žádný funkční dopad.
```
Set-AzVM -InputObject $VM -Name $Name ...

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

Set-AzVM -ResourceId $Id ...
```
Pro konzistenci odebraný parametr Name ze sad parametrů ByObject a ByResourceId v Save-AzVMImage

Před

Všimněte si, že následující kód je funkční, ale předaný název se nepoužívá, takže odebrání tohoto parametru nemá žádný funkční dopad.
```
Save-AzVMImage -InputObject $VM -Name $Name ...

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

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

Přidána vlastnost ProtectionPolicy k zapouzdření vlastnosti ProtectFromScaleIn v PSVirtualMachineScaleSetVM

Před

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

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

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

Po

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

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

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

Přidána byla vlastnost EncryptionSettingsCollection, aby byla vlastnost EncryptionSettings uzavřena v PSDisk.

Před

$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

Po

$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

Přidána vlastnost EncryptionSettingsCollection pro uzavření vlastnosti EncryptionSettings v PSSnapshot

Před

$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

Po

$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

Odstraněna vlastnost VirtualMachineProfile z PSVirtualMachineScaleSet

Před

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

Po

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

Cmdlet Set-AzVMBootDiagnostic odebral alias pro Set-AzVMBootDiagnostics

Před

Použití zastaralého aliasu
```
Set-AzVMBootDiagnostics
```
Po
```
Set-AzVMBootDIagnostic
```
Rutina Export-AzLogAnalyticThrottledRequest odstranila alias k Export-AzLogAnalyticThrottledRequests.

Před

Použití zastaralého aliasu
```
Export-AzLogAnalyticThrottledRequests
```
Po
```
Export-AzLogAnalyticThrottledRequest
```

Az.HDInsight

Odebraly se cmdlety Grant-AzHDInsightHttpServicesAccess a Revoke-AzHDInsightHttpServicesAccess. Ty už nejsou potřeba, protože přístup HTTP je vždy povolený ve všech clusterech HDInsight.
Byla přidána nová rutina Set-AzHDInsightGatewayCredential. Pomocí této rutiny můžete změnit uživatelské jméno a heslo HTTP brány (nahrazuje Grant-AzHDInsightHttpServicesAccess).
Aktualizace rutiny Get-AzHDInsightJobOutput tak, aby podporovala podrobný přístup na základě role ke klíči úložiště.
- Uživatelé s rolí operátora clusteru HDInsight, přispěvatele nebo vlastníka nebudou ovlivněni.
- Uživatelé, kteří mají pouze roli Čtenář, budou muset explicitně zadat DefaultStorageAccountKey parametr.

Další informace o těchto změnách přístupu založených na rolích najdete v tématu aka.ms/hdi-config-update

Před

Grant-AzHDInsightHttpServicesAccess -ClusterName $cluster -HttpCredential $credential

Po

Set-AzHDInsightGatewayCredential -ClusterName $cluster -HttpCredential $credential

Uživatelé, kteří mají pouze roli Čtenář pro cmdlet Get-AzHDInsightJobOutput

Před

Get-AzHDInsightJobOutput  -ClusterName $clusterName -JobId $jobId

Po

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

Az.Storage

Obory názvů pro typy vrácené rutinami Blob, Queue a File změnily jejich obor názvů z Microsoft.WindowsAzure.Storage na Microsoft.Azure.Storage. I když se nejedná o technicky zásadní změnu v závislosti na zásadách zásadních změn, může vyžadovat určité změny kódu, které používají metody ze sady Storage .Net SDK k interakci s objekty vrácenými z těchto rutin.

Příklad 1: Přidání zprávy do fronty (změna oboru názvů objektu CloudQueueMessage)

Před:

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

Po:

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

Příklad 2: Načtení atributů objektu blob nebo souboru pomocí AccessCondition (změna oboru názvů objektu AccessCondition)

Před:

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

Po:

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

I když není technicky zásadní změna, všimněte si výstupních rozdílů ve vlastnosti Sku.Name účtů úložiště vrácených z New/Get/Set-AzStorageAccount změn jsou následující. (Po změně se SkuName výstupu a vstupu zarovnají.)
- StandardLRS –> "Standard_LRS";
- StandardGRS –> "Standard_GRS";
- "StandardRAGRS" –> "Standard_RAGRS";
- StandardZRS –> "Standard_ZRS";
- "PremiumLRS" –> "Premium_LRS";

Výchozí chování služby při vytváření účtu úložiště bez určení druhu se změnilo. V předchozích verzích se při vytvoření účtu úložiště bez zadání Kind použil druh Storage účtu úložiště, v nové verzi StorageV2 je výchozí hodnota Kind. Pokud potřebujete vytvořit účet úložiště V1 s typem Storage, přidejte parametr -Kind Storage.

Příklad: Vytvoření účtu úložiště (změna výchozího typu)

Před:

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

Po:

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

Sdílet prostřednictvím

Průvodce migrací pro Az 2.0.0

Obsah

Změny narušující kompatibilitu modulu

Az.Compute

Před

Po

Před

Po

Před

Po

Před

Po

Před

Po

Před

Po

Před

Po

Před

Po

Před

Po

Před

Po

Před

Po

Před

Po

Před

Po

Před

Po

Az.HDInsight

Před

Po

Uživatelé, kteří mají pouze roli Čtenář pro cmdlet Get-AzHDInsightJobOutput

Před

Po

Az.Storage

Příklad 1: Přidání zprávy do fronty (změna oboru názvů objektu CloudQueueMessage)

Příklad 2: Načtení atributů objektu blob nebo souboru pomocí AccessCondition (změna oboru názvů objektu AccessCondition)

Příklad: Vytvoření účtu úložiště (změna výchozího typu)

Další materiály