Migratiehandleiding voor Az 2.0.0

Artikel
03/05/2025

In dit document worden de wijzigingen tussen de versies 1.0.0 en 2.0.0 van Az beschreven

Inhoudsopgave

module belangrijke wijzigingen

Belangrijke wijzigingen in de module

Az.Compute

De parameter Managed is verwijderd uit de New-AzAvailabilitySet- en Update-AzAvailabilitySet-cmdlets ten gunste van het gebruik van Sku = Aligned.

Voor
```
Update-AzAvailabilitySet -Managed
```
Na
```
Update-AzAvailabilitySet -Sku Aligned
```
Voor consistentie hebt u Image parameter verwijderd uit de parametersets ByName en ByResourceId in Update-AzImage

Voor

Houd er rekening mee dat de onderstaande code functioneel is, maar de doorgegeven ImageName niet wordt gebruikt, dus het verwijderen van deze parameter heeft geen functionele invloed.
```
Update-AzImage -ResourceGroupName $Rg -ImageName $Name -Image $Image -Tag $tags

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

Update-AzImage -ResourceId $Id -Tag $tags
```
Voor consistentie hebt u Name parameter verwijderd uit de parametersets ByObject en ByResourceId in Restart-AzVM

Voor

Houd er rekening mee dat de onderstaande code functioneel is, maar de doorgegeven naam niet wordt gebruikt, dus het verwijderen van deze parameter heeft geen functionele invloed.
```
Restart-AzVM -InputObject $VM -Name $Name

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

Restart-AzVM -ResourceId $Id
```
Voor consistentie hebt u Name parameter verwijderd uit de parametersets ByObject en ByResourceId in Start-AzVM

Voor

Houd er rekening mee dat de onderstaande code functioneel is, maar de doorgegeven naam niet wordt gebruikt, dus het verwijderen van deze parameter heeft geen functionele invloed.
```
Start-AzVM -InputObject $VM -Name $Name

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

Start-AzVM -ResourceId $Id
```
Voor consistentie hebt u Name parameter verwijderd uit de parametersets ByObject en ByResourceId in Stop-AzVM

Voor

Houd er rekening mee dat de onderstaande code functioneel is, maar de doorgegeven naam niet wordt gebruikt, dus het verwijderen van deze parameter heeft geen functionele invloed.
```
Stop-AzVM -InputObject $VM -Name $Name

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

Stop-AzVM -ResourceId $Id
```
Voor consistentie hebt u Name parameter verwijderd uit de parametersets ByObject en ByResourceId in Remove-AzVM

Voor

Houd er rekening mee dat de onderstaande code functioneel is, maar de doorgegeven naam niet wordt gebruikt, dus het verwijderen van deze parameter heeft geen functionele invloed.
```
Remove-AzVM -InputObject $VM -Name $Name

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

Remove-AzVM -ResourceId $Id
```
Voor consistentie hebt u Name parameter verwijderd uit de parametersets ByObject en ByResourceId in Set-AzVM

Voor

Houd er rekening mee dat de onderstaande code functioneel is, maar de doorgegeven naam niet wordt gebruikt, dus het verwijderen van deze parameter heeft geen functionele invloed.
```
Set-AzVM -InputObject $VM -Name $Name ...

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

Set-AzVM -ResourceId $Id ...
```
Voor consistentie hebt u Name parameter verwijderd uit de parametersets ByObject en ByResourceId in Save-AzVMImage

Voor

Houd er rekening mee dat de onderstaande code functioneel is, maar de doorgegeven naam niet wordt gebruikt, dus het verwijderen van deze parameter heeft geen functionele invloed.
```
Save-AzVMImage -InputObject $VM -Name $Name ...

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

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

De ProtectionPolicy-eigenschap toegevoegd om de eigenschap ProtectFromScaleIn in PSVirtualMachineScaleSetVM in te kapselen.

Voor

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

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

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

Na

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

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

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

Eigenschap EncryptionSettingsCollection toegevoegd ter afsluiting van de eigenschap EncryptionSettings in PSDisk

Voor

$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

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

Eigenschap EncryptionSettingsCollection toegevoegd om eigenschap EncryptionSettings binnen PSSnapshot te sluiten.

Voor

$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

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

Eigenschap VirtualMachineProfile uit PSVirtualMachineScaleSet verwijderd

Voor

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

Na

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

Cmdlet Set-AzVMBootDiagnostic heeft alias voor Set-AzVMBootDiagnostics verwijderd

Voor

Afgeschafte alias gebruiken
```
Set-AzVMBootDiagnostics
```
Na
```
Set-AzVMBootDIagnostic
```
Cmdlet Export-AzLogAnalyticThrottledRequest heeft alias naar Export-AzLogAnalyticThrottledRequests verwijderd

Voor

Verouderde alias gebruiken
```
Export-AzLogAnalyticThrottledRequests
```
Na
```
Export-AzLogAnalyticThrottledRequest
```

Az.HDInsight

De cmdlets Grant-AzHDInsightHttpServicesAccess en Revoke-AzHDInsightHttpServicesAccess verwijderd. Deze zijn niet meer nodig omdat HTTP-toegang altijd is ingeschakeld op alle HDInsight-clusters.
Er is een nieuwe Set-AzHDInsightGatewayCredential-cmdlet toegevoegd. Gebruik deze cmdlet om de HTTP-gebruikersnaam en het wachtwoord van de gateway te wijzigen (vervangt Grant-AzHDInsightHttpServicesAccess).
De cmdlet Get-AzHDInsightJobOutput bijgewerkt om granulaire, rolgebaseerde toegang tot de opslagsleutel te ondersteunen.
- Gebruikers met de rollen HDInsight-clusteroperator, Inzender of Eigenaar worden niet beïnvloed.
- Gebruikers met alleen de rol Lezer moeten expliciet DefaultStorageAccountKey parameter opgeven.

Zie aka.ms/hdi-config-update voor meer informatie over deze op rollen gebaseerde toegangswijzigingen

Voor

Grant-AzHDInsightHttpServicesAccess -ClusterName $cluster -HttpCredential $credential

Na

Set-AzHDInsightGatewayCredential -ClusterName $cluster -HttpCredential $credential

Gebruikers met alleen de rol Lezer voor cmdlet-Get-AzHDInsightJobOutput

Voor

Get-AzHDInsightJobOutput  -ClusterName $clusterName -JobId $jobId

Na

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

Az.Storage

Naamruimten voor typen die worden geretourneerd door blob-, wachtrij- en bestands-cmdlets hebben hun naamruimte gewijzigd van Microsoft.WindowsAzure.Storage in Microsoft.Azure.Storage. Hoewel dit technisch gezien geen brekende wijziging is volgens het brekende wijzigingsbeleid, kunnen er in de code die gebruikmaakt van de methoden van de Storage .Net SDK mogelijk enkele aanpassingen nodig zijn om te communiceren met de objecten die door deze cmdlets worden geretourneerd.

Voorbeeld 1: Een bericht toevoegen aan een wachtrij (de naamruimte van het CloudQueueMessage-object wijzigen)

Voor:

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

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)

Voorbeeld 2: Blob-/bestandskenmerken ophalen met AccessCondition (objectnaamruimte AccessCondition wijzigen)

Voor:

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

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)

Hoewel dit technisch gezien geen ingrijpende wijziging is, zult u verschillen in de uitvoer opmerken in de eigenschap Sku.Name van opslagaccounts die worden geretourneerd door New/Get/Set-AzStorageAccount, zoals hieronder weergegeven. (Na de wijziging worden uitvoer en invoer-SkuName uitgelijnd.)
- "StandardLRS" -> "Standard_LRS";
- "StandardGRS" -> "Standard_GRS";
- "StandardRAGRS" -> "Standard_RAGRS";
- "StandardZRS" -> "Standard_ZRS";
- "PremiumLRS" -> "Premium_LRS";

Het standaardservicegedrag bij het maken van een opslagaccount zonder een type op te geven is gewijzigd. In eerdere versies, wanneer een opslagaccount is gemaakt zonder Kind opgegeven, is het opslagaccounttype van Storage gebruikt, in de nieuwe versie is StorageV2 de standaardwaarde Kind. Als u een V1-opslagaccount wilt maken met het type 'Opslag', voegt u de parameter '-Kind Storage' toe

Voorbeeld: Een opslagaccount maken (wijziging van het standaardtype)

Voor:

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

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

Delen via

Migratiehandleiding voor Az 2.0.0

Inhoudsopgave

Belangrijke wijzigingen in de module

Az.Compute

Voor

Na

Voor

Na

Voor

Na

Voor

Na

Voor

Na

Voor

Na

Voor

Na

Voor

Na

Voor

Na

Voor

Na

Voor

Na

Voor

Na

Voor

Na

Voor

Na

Az.HDInsight

Voor

Na

Gebruikers met alleen de rol Lezer voor cmdlet-Get-AzHDInsightJobOutput

Voor

Na

Az.Storage

Voorbeeld 1: Een bericht toevoegen aan een wachtrij (de naamruimte van het CloudQueueMessage-object wijzigen)

Voorbeeld 2: Blob-/bestandskenmerken ophalen met AccessCondition (objectnaamruimte AccessCondition wijzigen)

Voorbeeld: Een opslagaccount maken (wijziging van het standaardtype)

Aanvullende resources