Migrálási útmutató az Az 2.0.0-s verziójához

Cikk
04/02/2024

Ez a dokumentum ismerteti, hogy milyen módosítások történtek az Az 1.0.0-s és 2.0.0-s verziója között

Tartalomjegyzék

A modul kompatibilitástörő változásai

A modul kompatibilitástörő változásai

Az.Compute

A New-AzAvailabilitySet és Update-AzAvailabilitySet parancsmag Managed paraméterét a következő váltotta fel: Sku = Aligned

Előtte
```
Update-AzAvailabilitySet -Managed
```
Utána
```
Update-AzAvailabilitySet -Sku Aligned
```
A konzisztencia érdekében az Image paraméter el lett távolítva az Update-AzImage „ByName” és a „ByResourceId” paraméterkészleteiből

Előtte

Vegye figyelembe, hogy az alábbi kód működik, de nem használja az átadott ImageName paramétert, így a paraméter eltávolítása nem befolyásolja a működését.
```
Update-AzImage -ResourceGroupName $Rg -ImageName $Name -Image $Image -Tag $tags

Update-AzImage -ResourceId $Id -Image $Image -Tag $tags
```
Utána
```
Update-AzImage -ResourceGroupName $Rg -ImageName $Name -Tag $tags

Update-AzImage -ResourceId $Id -Tag $tags
```
A konzisztencia érdekében a Name paraméter el lett távolítva a Restart-AzVM „ByObject” és „ByResourceId” paraméterkészleteiből

Előtte

Vegye figyelembe, hogy az alábbi kód működik, de nem használja az átadott Name paramétert, így a paraméter eltávolítása nem befolyásolja a működését.
```
Restart-AzVM -InputObject $VM -Name $Name

Restart-AzVM -ResourceId $Id -Name $Name
```
Utána
```
Restart-AzVM -InputObject $VM

Restart-AzVM -ResourceId $Id
```
A konzisztencia érdekében a Name paraméter el lett távolítva a Start-AzVM „ByObject” és „ByResourceId” paraméterkészleteiből

Előtte

Vegye figyelembe, hogy az alábbi kód működik, de nem használja az átadott Name paramétert, így a paraméter eltávolítása nem befolyásolja a működését.
```
Start-AzVM -InputObject $VM -Name $Name

Start-AzVM -ResourceId $Id -Name $Name
```
Utána
```
Start-AzVM -InputObject $VM

Start-AzVM -ResourceId $Id
```
A konzisztencia érdekében a Name paraméter el lett távolítva a Stop-AzVM „ByObject” és „ByResourceId” paraméterkészleteiből

Előtte

Vegye figyelembe, hogy az alábbi kód működik, de nem használja az átadott Name paramétert, így a paraméter eltávolítása nem befolyásolja a működését.
```
Stop-AzVM -InputObject $VM -Name $Name

Stop-AzVM -ResourceId $Id -Name $Name
```
Utána
```
Stop-AzVM -InputObject $VM

Stop-AzVM -ResourceId $Id
```
A konzisztencia érdekében a Name paraméter el lett távolítva a Remove-AzVM „ByObject” és „ByResourceId” paraméterkészleteiből

Előtte

Vegye figyelembe, hogy az alábbi kód működik, de nem használja az átadott Name paramétert, így a paraméter eltávolítása nem befolyásolja a működését.
```
Remove-AzVM -InputObject $VM -Name $Name

Remove-AzVM -ResourceId $Id -Name $Name
```
Utána
```
Remove-AzVM -InputObject $VM

Remove-AzVM -ResourceId $Id
```
A konzisztencia érdekében a Name paraméter el lett távolítva a Set-AzVM „ByObject” és „ByResourceId” paraméterkészleteiből

Előtte

Vegye figyelembe, hogy az alábbi kód működik, de nem használja az átadott Name paramétert, így a paraméter eltávolítása nem befolyásolja a működését.
```
Set-AzVM -InputObject $VM -Name $Name ...

Set-AzVM -ResourceId $Id -Name $Name ...
```
Utána
```
Set-AzVM -InputObject $VM ...

Set-AzVM -ResourceId $Id ...
```
A konzisztencia érdekében a Name paraméter el lett távolítva a Save-AzVMImage „ByObject” és „ByResourceId” paraméterkészleteiből

Előtte

Vegye figyelembe, hogy az alábbi kód működik, de nem használja az átadott Name paramétert, így a paraméter eltávolítása nem befolyásolja a működését.
```
Save-AzVMImage -InputObject $VM -Name $Name ...

Save-AzVMImage -ResourceId $Id -Name $Name ...
```
Utána
```
Save-AzVMImage -InputObject $VM ...

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

A ProtectionPolicy tulajdonság hozzá lett adva, hogy beágyazza a ProtectFromScaleIn tulajdonságot a következőbe: PSVirtualMachineScaleSetVM

Előtte

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

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

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

Utána

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

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

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

Az EncryptionSettingsCollection tulajdonság hozzá lett adva, hogy belefoglalja az EncryptionSettings tulajdonságot a következőbe: PSDisk

Előtte

$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

Utána

$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

Az EncryptionSettingsCollection tulajdonság hozzá lett adva, hogy belefoglalja az EncryptionSettings tulajdonságot a következőbe: PSSnapshot

Előtte

$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

Utána

$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 tulajdonság eltávolítva a következőből: PSVirtualMachineScaleSet

Előtte

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

Utána

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

A Set-AzVMBootDiagnostic parancsmag eltávolította az aliast a következőből: Set-AzVMBootDiagnostics

Előtte

Elavult alias használata
```
Set-AzVMBootDiagnostics
```
Utána
```
Set-AzVMBootDIagnostic
```
A Export-AzLogAnalyticThrottledRequest parancsmag eltávolította az aliast a következőből: Export-AzLogAnalyticThrottledRequests

Előtte

Elavult alias használata
```
Export-AzLogAnalyticThrottledRequests
```
Utána
```
Export-AzLogAnalyticThrottledRequest
```

Az.HDInsight

A Grant-AzHDInsightHttpServicesAccess és a Revoke-AzHDInsightHttpServicesAccess parancsmag el lett távolítva. Már nincs szükség rájuk, mivel a HTTP-hozzáférés mindig engedélyezve van a HDInsight-fürtökön.
Új Set-AzHDInsightGatewayCredential parancsmag hozzáadva. A parancsmag használatával módosíthatja az átjáró HTTP-felhasználónevét és -jelszavát (a Grant-AzHDInsightHttpServicesAccess helyébe lép).
Frissült a Get-AzHDInsightJobOutput parancsmag, és mostantól támogatja a tárkulcshoz való részletes szerepköralapú hozzáférést.
- Ez nem érinti a HDInsight-fürt operátor, közreműködő vagy tulajdonos szerepkörrel rendelkező felhasználóit.
- A csak olvasói szerepkörrel rendelkező felhasználóknak explicit módon meg kell adniuk a DefaultStorageAccountKey paramétert.

A szerepköralapú hozzáférés változásaival kapcsolatos további információért lásd: aka.ms/hdi-config-update

Előtte

Grant-AzHDInsightHttpServicesAccess -ClusterName $cluster -HttpCredential $credential

Utána

Set-AzHDInsightGatewayCredential -ClusterName $cluster -HttpCredential $credential

A Get-AzHDInsightJobOutput parancsmaghoz csak olvasói szerepkörrel rendelkező felhasználók

Előtte

Get-AzHDInsightJobOutput  -ClusterName $clusterName -JobId $jobId

Utána

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

Az.Storage

A Blob, a Queue és a File parancsmagok által visszaadott típusok névterei Microsoft.WindowsAzure.Storage-ról Microsoft.Azure.Storage-ra módosultak. Bár ez a kompatibilitástörő változások szabályzata szerint technikailag nem számít kompatibilitástörő változásnak, előfordulhat, hogy végre kell hajtani néhány módosítást olyan kódokban, amelyek a Storage .Net SDK metódusaival kommunikálnak a parancsmagok által visszaadott objektumokkal.

1. példa: Üzenet hozzáadása üzenetsorhoz (CloudQueueMessage objektumnévtér módosítása)

Előtte:

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

Utána:

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

2. példa: Blob/Fájlattribútumok beolvasása AccessCondition használatával (AccessCondition objektumnévtér módosítása)

Előtte:

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

Utána:

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

Bár technikailag nem egy kompatibilitástörő változás, a változásokból New/Get/Set-AzStorageAccount visszaadott tárfiókok Sku.Name tulajdonságának kimeneti különbségei a következők. (A módosítás után a SkuName kimenete és bemenete egymáshoz lesz igazítva.)
- "StandardLRS" -> "Standard_LRS";
- "StandardGRS" -> "Standard_GRS";
- "StandardRAGRS" -> "Standard_RAGRS";
- "StandardZRS" -> "Standard_ZRS";
- "PremiumLRS" -> "Premium_LRS";

Megváltozott a szolgáltatás alapértelmezett viselkedése a tárfiókok altípus megadása nélküli létrehozásakor. A korábbi verziókban a tárfiókok Kind megadása nélküli létrehozásakor a rendszer a tárfiók Storage altípusát használta. Az új verzióban a StorageV2 a Kind alapértelmezett értéke. Ha létre kell hoznia egy V1-tárfiókot a „Storage” altípussal, adja hozzá a „-Kind Storage” paramétert.

Példa: Tárfiók létrehozása (alapértelmezett típusmódosítás)

Előtte:

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

Utána:

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

Migrálási útmutató az Az 2.0.0-s verziójához

Tartalomjegyzék

A modul kompatibilitástörő változásai

Az.Compute

Előtte

Utána

Előtte

Utána

Előtte

Utána

Előtte

Utána

Előtte

Utána

Előtte

Utána

Előtte

Utána

Előtte

Utána

Előtte

Utána

Előtte

Utána

Előtte

Utána

Előtte

Utána

Előtte

Utána

Előtte

Utána

Az.HDInsight

Előtte

Utána

A Get-AzHDInsightJobOutput parancsmaghoz csak olvasói szerepkörrel rendelkező felhasználók

Előtte

Utána

Az.Storage

1. példa: Üzenet hozzáadása üzenetsorhoz (CloudQueueMessage objektumnévtér módosítása)

2. példa: Blob/Fájlattribútumok beolvasása AccessCondition használatával (AccessCondition objektumnévtér módosítása)

Példa: Tárfiók létrehozása (alapértelmezett típusmódosítás)

További források