Migratiehandleiding voor Az 2.0.0

  • Artikel

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

    Vóór

    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

    Zodra

    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

    Vóór

    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

    Zodra

    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

    Vóór

    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

    Zodra

    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

    Vóór

    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

    Zodra

    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

    Vóór

    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

    Zodra

    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

    Vóór

    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 ...

    Zodra

    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

    Vóór

    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 ...

    Zodra

    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

    Vóór

    Afgeschafte alias gebruiken

    Set-AzVMBootDiagnostics

    Zodra

    Set-AzVMBootDIagnostic

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

    Vóór

    Afgeschafte alias gebruiken

    Export-AzLogAnalyticThrottledRequests

    Zodra

    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 (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 geen belangrijke wijziging is, ziet u uitvoerverschillen in de eigenschap Sku.Name van Opslagaccounts die worden geretourneerd door New/Get/Set-AzStorageAccount wijzigingen als volgt. (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