Migratiehandleiding voor Az 2.0.0

  • Artikel
  • 5 minuten om te lezen

In dit document worden de verschillen tussen de Az-versies 1.0.0 en 2.0.0 beschreven

Inhoudsopgave

Belangrijke modulewijzigingen

Az.Compute

  • Parameter Managed verwijderd uit de cmdlets New-AzAvailabilitySet en Update-AzAvailabilitySet ten gunste van het gebruik van Sku = Aligned

    Voor

    Update-AzAvailabilitySet -Managed

    Na

    Update-AzAvailabilitySet -Sku Aligned

  • Met het oog op consistentie is parameter Image verwijderd uit de parametersets 'ByName' en 'ByResourceId' in Update-AzImage

    Voor

    De onderstaande code is functioneel, maar de ingegeven ImageName wordt niet gebruikt. Dit betekent dat het verwijderen van deze parameter geen functionele impact heeft.

    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

  • Met het oog op consistentie is parameter Name verwijderd uit de parametersets 'ByObject' en 'ByResourceId' in Restart-AzVM

    Voor

    De onderstaande code is functioneel, maar de ingegeven naam wordt niet gebruikt. Dit betekent dat het verwijderen van deze parameter geen functionele impact heeft.

    Restart-AzVM -InputObject $VM -Name $Name

Restart-AzVM -ResourceId $Id -Name $Name

    Na

    Restart-AzVM -InputObject $VM

Restart-AzVM -ResourceId $Id

  • Met het oog op consistentie is parameter Name verwijderd uit de parametersets 'ByObject' en 'ByResourceId' in Start-AzVM

    Voor

    De onderstaande code is functioneel, maar de ingegeven naam wordt niet gebruikt. Dit betekent dat het verwijderen van deze parameter geen functionele impact heeft.

    Start-AzVM -InputObject $VM -Name $Name

Start-AzVM -ResourceId $Id -Name $Name

    Na

    Start-AzVM -InputObject $VM

Start-AzVM -ResourceId $Id

  • Met het oog op consistentie is parameter Name verwijderd uit de parametersets 'ByObject' en 'ByResourceId' in Stop-AzVM

    Voor

    De onderstaande code is functioneel, maar de ingegeven naam wordt niet gebruikt. Dit betekent dat het verwijderen van deze parameter geen functionele impact heeft.

    Stop-AzVM -InputObject $VM -Name $Name

Stop-AzVM -ResourceId $Id -Name $Name

    Na

    Stop-AzVM -InputObject $VM

Stop-AzVM -ResourceId $Id

  • Met het oog op consistentie is parameter Name verwijderd uit de parametersets 'ByObject' en 'ByResourceId' in Remove-AzVM

    Voor

    De onderstaande code is functioneel, maar de ingegeven naam wordt niet gebruikt. Dit betekent dat het verwijderen van deze parameter geen functionele impact heeft.

    Remove-AzVM -InputObject $VM -Name $Name

Remove-AzVM -ResourceId $Id -Name $Name

    Na

    Remove-AzVM -InputObject $VM

Remove-AzVM -ResourceId $Id

  • Met het oog op consistentie is parameter Name verwijderd uit de parametersets 'ByObject' en 'ByResourceId' in Set-AzVM

    Voor

    De onderstaande code is functioneel, maar de ingegeven naam wordt niet gebruikt. Dit betekent dat het verwijderen van deze parameter geen functionele impact heeft.

    Set-AzVM -InputObject $VM -Name $Name ...

Set-AzVM -ResourceId $Id -Name $Name ...

    Na

    Set-AzVM -InputObject $VM ...

Set-AzVM -ResourceId $Id ...

  • Met het oog op consistentie is parameter Name verwijderd uit de parametersets 'ByObject' en 'ByResourceId' in Save-AzVMImage

    Voor

    De onderstaande code is functioneel, maar de ingegeven naam wordt niet gebruikt. Dit betekent dat het verwijderen van deze parameter geen functionele impact heeft.

    Save-AzVMImage -InputObject $VM -Name $Name ...

Save-AzVMImage -ResourceId $Id -Name $Name ...

    Na

    Save-AzVMImage -InputObject $VM ...

Save-AzVMImage -ResourceId $Id ...

  • De eigenschap ProtectionPolicy is toegevoegd om eigenschap ProtectFromScaleIn in te kapselen in PSVirtualMachineScaleSetVM

    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 om eigenschap EncryptionSettings in te sluiten 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 in te sluiten in PSSnapshot

    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 verwijderd uit PSVirtualMachineScaleSet

    Voor

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

    Na

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

  • Cmdlet Set-AzVMBootDiagnostic heeft alias naar Set-AzVMBootDiagnostics verwijderd

    Voor

    Afgeschafte alias gebruiken

    Set-AzVMBootDiagnostics

    Na

    Set-AzVMBootDIagnostic

  • Cmdlet Export-AzLogAnalyticThrottledRequest heeft alias naar Export-AzLogAnalyticThrottledRequests verwijderd

    Voor

    Afgeschafte alias gebruiken

    Export-AzLogAnalyticThrottledRequests

    Na

    Export-AzLogAnalyticThrottledRequest

Az.HDInsight

  • Cmdlets Grant-AzHDInsightHttpServicesAccess en Revoke-AzHDInsightHttpServicesAccess zijn verwijderd. Deze zijn niet langer nodig omdat HTTP-toegang altijd is ingeschakeld op alle HDInsight-clusters.
  • Nieuwe cmdlet Set-AzHDInsightGatewayCredential toegevoegd. Gebruik deze cmdlet om de HTTP-gebruikersnaam en het wachtwoord van de gateway te wijzigen (vervangt Grant-AzHDInsightHttpServicesAccess).
  • Cmdlet Get-AzHDInsightJobOutput bijgewerkt om nauwkeurige op rollen gebaseerde toegang tot de opslagsleutel te ondersteunen.
    • Gebruikers met de HDInsight Cluster-rollen Operator, Bijdrager of Eigenaar worden niet beïnvloed.
    • Gebruikers met alleen de rol Lezer moeten de parameter DefaultStorageAccountKey expliciet 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 de 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 vanuit blob-, wachtrij- en bestand-cmdlets zijn geretourneerd, hebben hun naamruimte gewijzigd van Microsoft.WindowsAzure.Storage naar Microsoft.Azure.Storage. Hoewel dit technisch gezien geen belangrijke wijziging is volgens het desbetreffende beleid, kan het een aantal wijzigingen vereisen in de code die gebruikmaakt van de methoden uit de Storage .Net-SDK om te communiceren met de objecten die vanuit deze cmdlets worden geretourneerd.

    Voorbeeld 1: Een bericht toevoegen aan een wachtrij (objectnaamruimte CloudQueueMessage 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 het technisch geen belangrijke wijziging is, ziet u dat de uitvoerverschillen in de eigenschap Sku.Name van opslagaccounts die worden geretourneerd door New/Get/Set-AzStorageAccount wijzigingen, als volgt zijn. (Na de wijziging worden de invoer- en uitvoer-SkuName uitgelijnd.)

    • "StandardLRS" -> "Standard_LRS";
    • "StandardGRS" -> "Standard_GRS";
    • "StandardRAGRS" -> "Standard_RAGRS";
    • "StandardZRS" -> "Standard_ZRS";
    • "PremiumLRS" -> "Premium_LRS";

  • Het standaard servicegedrag bij het maken van een opslagaccount zonder vermelding van een soort is veranderd. In vorige versies, waarin opslagaccounts zonder opgegeven Kind werden gemaakt, werd het opslagaccount Storage als soort gebruikt. In de nieuwe versie is StorageV2 de standaardwaarde Kind. Als u een V1-opslagaccount van de soort Opslag moet maken, voegt u de parameter '-soort opslag' toe

    Voorbeeld: Een opslagaccount maken (wijziging 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