Průvodce migrací pro Az 2.0.0

Článek
11/06/2024

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

Obsah

Zásadní změny modulů

Zásadní změny modulů

Az.Compute

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

Před
```
Update-AzAvailabilitySet -Managed
```
Po
```
Update-AzAvailabilitySet -Sku Aligned
```
Odebrání parametru Image ze sad parametrů ByName a ByResourceId v rutině Update-AzImage pro zajištění konzistence

Před

Všimněte si, že následující kód je funkční, ale předaný parametr ImageName se nepoužívá, takže jeho odebrání na funkčnost kódu nebude mít vliv.
```
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
```
Odebrání parametru Name ze sad parametrů ByObject a ByResourceId v rutině Restart-AzVM pro zajištění konzistence

Před

Všimněte si, že následující kód je funkční, ale předaný parametr Name se nepoužívá, takže jeho odebrání na funkčnost kódu nebude mít vliv.
```
Restart-AzVM -InputObject $VM -Name $Name

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

Restart-AzVM -ResourceId $Id
```
Odebrání parametru Name ze sad parametrů ByObject a ByResourceId v rutině Start-AzVM pro zajištění konzistence

Před

Všimněte si, že následující kód je funkční, ale předaný parametr Name se nepoužívá, takže jeho odebrání na funkčnost kódu nebude mít vliv.
```
Start-AzVM -InputObject $VM -Name $Name

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

Start-AzVM -ResourceId $Id
```
Odebrání parametru Name ze sad parametrů ByObject a ByResourceId v rutině Stop-AzVM pro zajištění konzistence

Před

Všimněte si, že následující kód je funkční, ale předaný parametr Name se nepoužívá, takže jeho odebrání na funkčnost kódu nebude mít vliv.
```
Stop-AzVM -InputObject $VM -Name $Name

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

Stop-AzVM -ResourceId $Id
```
Odebrání parametru Name ze sad parametrů ByObject a ByResourceId v rutině Remove-AzVM pro zajištění konzistence

Před

Všimněte si, že následující kód je funkční, ale předaný parametr Name se nepoužívá, takže jeho odebrání na funkčnost kódu nebude mít vliv.
```
Remove-AzVM -InputObject $VM -Name $Name

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

Remove-AzVM -ResourceId $Id
```
Odebrání parametru Name ze sad parametrů ByObject a ByResourceId v rutině Set-AzVM pro zajištění konzistence

Před

Všimněte si, že následující kód je funkční, ale předaný parametr Name se nepoužívá, takže jeho odebrání na funkčnost kódu nebude mít vliv.
```
Set-AzVM -InputObject $VM -Name $Name ...

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

Set-AzVM -ResourceId $Id ...
```
Odebrání parametru Name ze sad parametrů ByObject a ByResourceId v rutině Save-AzVMImage pro zajištění konzistence

Před

Všimněte si, že následující kód je funkční, ale předaný parametr Name se nepoužívá, takže jeho odebrání na funkčnost kódu nebude mít vliv.
```
Save-AzVMImage -InputObject $VM -Name $Name ...

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

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

Přidání vlastnosti ProtectionPolicy pro zapouzdření vlastnosti ProtectFromScaleIn ve třídě 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ání vlastnosti EncryptionSettingsCollection pro uzavření vlastnosti EncryptionSettings ve třídě 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ání vlastnosti EncryptionSettingsCollection pro uzavření vlastnosti EncryptionSettings ve třídě 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

Odebrání vlastnosti VirtualMachineProfile z třídy PSVirtualMachineScaleSet

Před

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

Po

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

Odebrání aliasu Set-AzVMBootDiagnostics pro rutinu Set-AzVMBootDiagnostic

Před

Použití zastaralého aliasu
```
Set-AzVMBootDiagnostics
```
Po
```
Set-AzVMBootDIagnostic
```
Odebrání aliasu Export-AzLogAnalyticThrottledRequests pro rutinu Export-AzLogAnalyticThrottledRequest

Před

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

Az.HDInsight

Odebrání rutin Grant-AzHDInsightHttpServicesAccess a Revoke-AzHDInsightHttpServicesAccess. Tyto rutiny už nejsou potřeba, protože na všech clusterech HDInsight je vždy povolený přístup HTTP.
Přidání nové rutiny Set-AzHDInsightGatewayCredential. Pomocí této rutiny můžete změnit uživatelské jméno a heslo HTTP pro bránu (tato rutina nahrazuje rutinu Grant-AzHDInsightHttpServicesAccess).
Aktualizace rutiny Get-AzHDInsightJobOutput tak, aby podporovala podrobné řízení přístupu na základě role ke klíči úložiště.
- Uživatelů s rolemi Vlastník, Přispěvatel a Operátor clusteru HDInsight se tato změna nedotkne.
- Pouze uživatelé s rolí Čtenář budou muset explicitně zadat parametr DefaultStorageAccountKey.

Další informace o těchto změnách řízení přístupu na základě role najdete na stránce aka.ms/hdi-config-update.

Před

Grant-AzHDInsightHttpServicesAccess -ClusterName $cluster -HttpCredential $credential

Po

Set-AzHDInsightGatewayCredential -ClusterName $cluster -HttpCredential $credential

Uživatelé pouze s rolí Čtenář pro rutinu Get-AzHDInsightJobOutput

Před

Get-AzHDInsightJobOutput  -ClusterName $clusterName -JobId $jobId

Po

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

Az.Storage

Došlo ke změně oborů názvů pro typy vrácené z rutin pro objekty blob, fronty a soubory z Microsoft.WindowsAzure.Storage na Microsoft.Azure.Storage. I když se technicky vzato z hlediska zásad pro zásadní změny nejedná o zásadní změnu, může to vyžadovat určité změny kódu, který pomocí metod ze sady .NET SDK služby Storage pracuje 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ů v Sku.Name vlastnosti účtů úložiště vrácených ze New/Get/Set-AzStorageAccount změn, jak je znázorněno níže. (Po provedení změny jsou vstupní a výstupní hodnoty SkuName stejné.)
- "StandardLRS" –> "Standard_LRS";
- "StandardGRS" -> "Standard_GRS";
- "StandardRAGRS" -> "Standard_RAGRS";
- "StandardZRS" –> "Standard_ZRS";
- "PremiumLRS" –> "Premium_LRS";

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

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

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

Zásadní změny modulů

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é pouze s rolí Čtenář pro rutinu 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ě (výchozí změna druhu)

Další materiály