Migreringsguide för Az 2.0.0

Artikel
11/04/2021
5 minuter för att läsa

I det här dokumentet beskrivs ändringarna mellan 1.0.0 och 2.0.0-versionen av Az

Innehållsförteckning

Ändra modulbrytning

Ändra modulbrytning

Az.Compute

Parameter Managed borttagen New-AzAvailabilitySet från och Update-AzAvailabilitySet cmdlets som du använder Sku = Aligned

Före
```
Update-AzAvailabilitySet -Managed
```
Efter
```
Update-AzAvailabilitySet -Sku Aligned
```
För konsekvens tas parameter Image bort från parameteruppsättningarna "ByName" och "ByResourceId" i Update-AzImage

Före

Observera att nedanstående kod fungerar, men att den skickade ImageName-koden inte används, så att borttagning av den här parametern inte har någon funktionell effekt.
```
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 konsekvens tas Name parametern bort från parameteruppsättningarna "ByObject" och "ByResourceId" i Restart-AzVM

Före

Observera att koden nedan fungerar, men att det förnamn som överförs inte används, så att borttagning av den här parametern inte har någon funktionell effekt.
```
Restart-AzVM -InputObject $VM -Name $Name

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

Restart-AzVM -ResourceId $Id
```
För konsekvens tas Name parametern bort från parameteruppsättningarna "ByObject" och "ByResourceId" i Start-AzVM

Före

Observera att koden nedan fungerar, men att det förnamn som överförs inte används, så att borttagning av den här parametern inte har någon funktionell effekt.
```
Start-AzVM -InputObject $VM -Name $Name

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

Start-AzVM -ResourceId $Id
```
För konsekvens tas Name parametern bort från parameteruppsättningarna "ByObject" och "ByResourceId" i Stop-AzVM

Före

Observera att koden nedan fungerar, men att det förnamn som överförs inte används, så att borttagning av den här parametern inte har någon funktionell effekt.
```
Stop-AzVM -InputObject $VM -Name $Name

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

Stop-AzVM -ResourceId $Id
```
För konsekvens tas Name parametern bort från parameteruppsättningarna "ByObject" och "ByResourceId" i Remove-AzVM

Före

Observera att koden nedan fungerar, men att det förnamn som överförs inte används, så att borttagning av den här parametern inte har någon funktionell effekt.
```
Remove-AzVM -InputObject $VM -Name $Name

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

Remove-AzVM -ResourceId $Id
```
För konsekvens tas Name parametern bort från parameteruppsättningarna "ByObject" och "ByResourceId" i Set-AzVM

Före

Observera att koden nedan fungerar, men att det förnamn som överförs inte används, så att borttagning av den här parametern inte har någon funktionell effekt.
```
Set-AzVM -InputObject $VM -Name $Name ...

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

Set-AzVM -ResourceId $Id ...
```
För konsekvens tas Name parametern bort från parameteruppsättningarna "ByObject" och "ByResourceId" i Save-AzVMImage

Före

Observera att koden nedan fungerar, men att det förnamn som överförs inte används, så att borttagning av den här parametern inte har någon funktionell effekt.
```
Save-AzVMImage -InputObject $VM -Name $Name ...

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

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

Egenskapen ProtectionPolicy tillagd för att ProtectFromScaleIn kapsla in egenskapen 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 Tillagd för att EncryptionSettings omsluta egenskapen 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 Tillagd för att EncryptionSettings omsluta egenskapen 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 VirtualMachineProfile Borttagen från PSVirtualMachineScaleSet

Före

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

Efter

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

Cmdlet Set-AzVMBootDiagnostic borttaget alias till Set-AzVMBootDiagnostics

Före

Använda inaktuella alias
```
Set-AzVMBootDiagnostics
```
Efter
```
Set-AzVMBootDIagnostic
```
Cmdlet Export-AzLogAnalyticThrottledRequest borttaget alias till Export-AzLogAnalyticThrottledRequests

Före

Använda utfasat alias
```
Export-AzLogAnalyticThrottledRequests
```
Efter
```
Export-AzLogAnalyticThrottledRequest
```

Az.HDInsight

Tog bort Grant-AzHDInsightHttpServicesAccess Revoke-AzHDInsightHttpServicesAccess cmdlet:arna och. Dessa krävs inte längre eftersom HTTP-åtkomst alltid är aktiverad i alla HDInsight-kluster.
Lade till en Set-AzHDInsightGatewayCredential ny cmdlet. Använd den här cmdleten för att ändra gatewayens HTTP-användarnamn och lösenord (ersätter Grant-AzHDInsightHttpServicesAccess ).
Uppdaterade Get-AzHDInsightJobOutput cmdleten för att stödja detaljerad rollbaserad åtkomst till lagringsnyckeln.
- Användare med HDInsight-klusteroperator, deltagare eller ägarroller påverkas inte.
- Användare med endast rollen Läsare måste uttryckligen ange DefaultStorageAccountKey parameter.

Mer information om de här rollbaserade åtkomständringarna 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 reader-roll för cmdlet-Get-AzHDInsightJobOutput

Före

Get-AzHDInsightJobOutput  -ClusterName $clusterName -JobId $jobId

Efter

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

Az.Storage

Namnområden för typer som returneras från blob-, kö- och filcmdlets har ändrat namnområdet Microsoft.WindowsAzure.Storage från till Microsoft.Azure.Storage . Även om detta tekniskt sett inte är en brytning enligt principen för brytningsändring kan det behövas vissa ändringar i kod som använder metoderna från Storage .Net SDK för att interagera med objekten som returneras från dessa cmdlets.

Exempel 1: Lägga 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 objektnamnområdet AccessCondition)

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 inte tekniskt sett är en brytning, märker du skillnader i utdata Sku.Name för Storage Konton som returneras från ändringarna New/Get/Set-AzStorageAccount är följande. (Efter ändringen justeras utdata och indata-SKUName.)
- "StandardLRS" -> "Standard_LRS";
- "StandardGRS" -> "Standard_GRS";
- "StandardRAGRS" -> "Standard_RAGRS";
- "StandardZRS" -> "Standard_ZRS";
- "PremiumLRS" -> "Premium_LRS";

Standardbeteendet för tjänster när ett lagringskonto med ett Kind-värde anges har ändrats. När ett lagringskonto skapades utan angivet i tidigare versioner Storage, används det nya kontots typ i Kind den nya versionen som Storage StorageV2 Kind standardvärde. Om du behöver skapa ett V1-Storage-konto med typen "Storage" lägger du till parametern "-kind Storage"

Exempel: Skapa ett lagringskonto (ändring av standardformat)

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

Migreringsguide för Az 2.0.0

Betygsätta din upplevelse

Innehållsförteckning

Ändra modulbrytning

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 reader-roll för cmdlet-Get-AzHDInsightJobOutput

Före

Efter

Az.Storage

Exempel 1: Lägga till ett meddelande i en kö (ändra CloudQueueMessage-objektnamnområdet)

Exempel 2: Hämta blob-/filattribut med AccessCondition (ändra objektnamnområdet AccessCondition)

Exempel: Skapa ett lagringskonto (ändring av standardformat)