New-AzDiskConfig
Hiermee maakt u een configureerbaar schijfobject.
Syntax
New-AzDiskConfig
[[-SkuName] <String>]
[-Tier <String>]
[-LogicalSectorSize <Int32>]
[[-OsType] <OperatingSystemTypes>]
[[-DiskSizeGB] <Int32>]
[[-Location] <String>]
[-EdgeZone <String>]
[-PurchasePlan <PSPurchasePlan>]
[-SupportsHibernation <Boolean>]
[-Zone <String[]>]
[-HyperVGeneration <String>]
[-DiskIOPSReadWrite <Int64>]
[-DiskMBpsReadWrite <Int64>]
[-DiskIOPSReadOnly <Int64>]
[-DiskMBpsReadOnly <Int64>]
[-MaxSharesCount <Int32>]
[-Tag <Hashtable>]
[-CreateOption <String>]
[-StorageAccountId <String>]
[-ImageReference <ImageDiskReference>]
[-GalleryImageReference <ImageDiskReference>]
[-SourceUri <String>]
[-SourceResourceId <String>]
[-UploadSizeInBytes <Int64>]
[-EncryptionSettingsEnabled <Boolean>]
[-DiskEncryptionKey <KeyVaultAndSecretReference>]
[-KeyEncryptionKey <KeyVaultAndKeyReference>]
[-DiskEncryptionSetId <String>]
[-EncryptionType <String>]
[-DiskAccessId <String>]
[-NetworkAccessPolicy <String>]
[-BurstingEnabled <Boolean>]
[-PublicNetworkAccess <String>]
[-AcceleratedNetwork <Boolean>]
[-DataAccessAuthMode <String>]
[-Architecture <String>]
[-PerformancePlus <Boolean>]
[-OptimizedForFrequentAttach <Boolean>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Met de cmdlet New-AzDiskConfig wordt een configureerbaar schijfobject gemaakt.
Voorbeelden
Voorbeeld 1
$diskconfig = New-AzDiskConfig -Location 'Central US' -DiskSizeGB 5 -SkuName Standard_LRS -OsType Windows -CreateOption Empty -EncryptionSettingsEnabled $true;
$secretUrl = 'https://myvault.vault-int.azure-int.net/secrets/123/';
$secretId = '/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup01/providers/Microsoft.KeyVault/vaults/TestVault123';
$keyUrl = 'https://myvault.vault-int.azure-int.net/keys/456';
$keyId = '/subscriptions/0000000-0000-0000-0000-000000000000/resourceGroups/ResourceGroup01/providers/Microsoft.KeyVault/vaults/TestVault456';
$diskconfig = Set-AzDiskDiskEncryptionKey -Disk $diskconfig -SecretUrl $secretUrl -SourceVaultId $secretId;
$diskconfig = Set-AzDiskKeyEncryptionKey -Disk $diskconfig -KeyUrl $keyUrl -SourceVaultId $keyId;
New-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -Disk $diskconfig;
Met de eerste opdracht maakt u een lokaal leeg schijfobject met de grootte van 5 GB in Standard_LRS opslagaccounttype. Ook wordt het type Windows-besturingssysteem ingesteld en worden versleutelingsinstellingen ingeschakeld. Met de tweede en derde opdrachten worden de instellingen voor schijfversleutelingssleutel en sleutelversleutelingssleutel voor het schijfobject ingesteld. Met de laatste opdracht wordt het schijfobject gebruikt en wordt een schijf gemaakt met de naam Disk01 in de resourcegroep ResourceGroup01.
Voorbeeld 2
$diskconfig = New-AzDiskConfig -Location 'Central US' -DiskSizeGB 1023 -SkuName Standard_LRS -OsType Windows -CreateOption Upload -DiskIOPSReadWrite 500 -DiskMBpsReadWrite 8;
New-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -Disk $diskconfig;
$diskSas = Grant-AzDiskAccess -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -DurationInSecond 86400 -Access 'Write'
$disk = Get-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01'
# $disk.DiskState == 'ReadyToUpload'
AzCopy /Source:https://myaccount.blob.core.windows.net/mycontainer1 /Dest:$diskSas
$disk = Get-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01'
# $disk.DiskState == 'ActiveUpload'
Revoke-AzDiskAccess -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01'
Met de eerste opdracht maakt u een lokaal schijfobject voor Uploaden. Met de tweede opdracht wordt het schijfobject gebruikt en wordt een schijf gemaakt met de naam Disk01 in de resourcegroep ResourceGroup01. Met de derde opdracht wordt de SAS-URL voor de schijf opgeslagen. Met de vierde opdracht krijgt u de status van de schijf. Als de schijfstatus ReadyToUpload is, kan een gebruiker een schijf van blobopslag uploaden naar de SAS-URL van de schijf met behulp van AzCopy. Tijdens het uploaden wordt de schijfstatus gewijzigd in 'ActiveUpload'. Met de laatste opdracht wordt de schijftoegang voor de SAS-URL ingetrokken.
Voorbeeld 3
$galleryImageReference = @{Id = '/subscriptions/0296790d-427c-48ca-b204-8b729bbd8670/resourceGroups/swaggertests/providers/Microsoft.Compute/galleries/swaggergallery/images/swaggerimagedef/versions/1.0.0'; Lun=1}
$diskConfig = New-AzDiskConfig -Location 'West US' -CreateOption 'FromImage' -GalleryImageReference $galleryImageReference;
New-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -Disk $diskConfig
Maak een schijf op basis van een installatiekopieënversie van een gedeelde galerie. Id is de id van de installatiekopieënversie van de gedeelde galerie. Lun is alleen nodig als de bron een gegevensschijf is.
Voorbeeld 4
$diskconfig = New-AzDiskConfig -Location 'Central US' -SkuName 'Standard_LRS' -OsType 'Windows' -UploadSizeInBytes 35183298347520 -CreateOption 'Upload' -OptimizedForFrequentAttach $true
New-AzDisk -ResourceGroupName 'ResourceGroup01' -DiskName 'Disk01' -Disk $diskConfig
Maak een schijf met OptimizedForFrequentAttach als true om de betrouwbaarheid en prestaties van de gegevensschijven te verbeteren die vaak (meer dan 5 keer per dag) worden losgekoppeld van de ene virtuele machine en aan een andere worden gekoppeld.
Parameters
-AcceleratedNetwork
Is waar als de installatiekopieën van waaruit de besturingssysteemschijf wordt gemaakt, ondersteuning bieden voor versneld netwerken.
Type: | Nullable<T>[Boolean] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Architecture
CPU-architectuur die wordt ondersteund door een besturingssysteemschijf. Mogelijke waarden zijn X64 en Arm64.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-BurstingEnabled
Maakt bursting mogelijk buiten het ingerichte prestatiedoel van de schijf. Bursting is standaard uitgeschakeld. Is niet van toepassing op Ultra-schijven.
Type: | Nullable<T>[Boolean] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CreateOption
Hiermee geeft u op of met deze cmdlet een schijf in de virtuele machine wordt gemaakt op basis van een platform- of gebruikersinstallatiekopieën, een lege schijf wordt gemaakt of een bestaande schijf wordt gekoppeld.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DataAccessAuthMode
Aanvullende verificatievereisten bij het exporteren of uploaden naar een schijf of momentopname.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DiskAccessId
Hiermee haalt u de ARM-id van de DiskAccess-resource op voor het gebruik van privé-eindpunten op.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskEncryptionKey
Hiermee geeft u het schijfversleutelingssleutelobject op een schijf.
Type: | KeyVaultAndSecretReference |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskEncryptionSetId
Hiermee geeft u de resource-id op van de schijfversleuteling die moet worden gebruikt voor het inschakelen van versleuteling at rest.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskIOPSReadOnly
Het totale aantal IOPS dat wordt toegestaan voor alle VM's die de gedeelde schijf koppelen als ReadOnly. Eén bewerking kan worden overgedragen tussen 4k en 256k bytes.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskIOPSReadWrite
Het aantal IOPS dat is toegestaan voor deze schijf; alleen instelbaar voor UltraSSD-schijven. Eén bewerking kan worden overgedragen tussen 4k en 256k bytes.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskMBpsReadOnly
De totale doorvoer (MBps) die wordt toegestaan voor alle VM's die de gedeelde schijf koppelen als ReadOnly. MBps betekent miljoenen bytes per seconde- MB maakt hier gebruik van de ISO-notatie, van bevoegdheden van 10.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskMBpsReadWrite
De bandbreedte die voor deze schijf is toegestaan; alleen instelbaar voor UltraSSD-schijven. MBps betekent miljoenen bytes per seconde- MB maakt hier gebruik van de ISO-notatie, van bevoegdheden van 10.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DiskSizeGB
Hiermee geeft u de grootte van de schijf in GB.
Type: | Int32 |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EdgeZone
Hiermee stelt u de naam van de randzone in. Als deze optie is ingesteld, wordt de query doorgestuurd naar de opgegeven edgezone in plaats van de hoofdregio.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EncryptionSettingsEnabled
Schakel versleutelingsinstellingen in.
Type: | Nullable<T>[Boolean] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-EncryptionType
Het type sleutel dat wordt gebruikt om de gegevens van de schijf te versleutelen. Beschikbare waarden zijn: 'EncryptionAtRestWithPlatformKey', 'EncryptionAtRestWithCustomerKey'
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-GalleryImageReference
Het Object GalleryImageReference. Vereist als u een galerie-installatiekopieën maakt. De id is de ARM-id van de versie van de gedeelde kombuisinstallatiekopie waaruit een schijf moet worden gemaakt. Er is een lun nodig als de bron van de kopie een van de gegevensschijven in de galerie-installatiekopie is; indien null, wordt de besturingssysteemschijf van de installatiekopieën gekopieerd.
Type: | ImageDiskReference |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-HyperVGeneration
De hypervisorgeneratie van de virtuele machine. Alleen van toepassing op besturingssysteemschijven. Toegestane waarden zijn V1 en V2.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ImageReference
Hiermee geeft u de installatiekopieënreferentie op een schijf. De id is de ARM-id van de PIR- of gebruikersinstallatiekopieën waaruit een schijf moet worden gemaakt. Er is een LUN nodig als de bron van de kopie een van de gegevensschijven in de galerie-installatiekopie is; indien null, wordt de besturingssysteemschijf van de installatiekopieën gekopieerd.
Type: | ImageDiskReference |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-KeyEncryptionKey
Hiermee geeft u de sleutelversleutelingssleutel op een schijf.
Type: | KeyVaultAndKeyReference |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Location
Hiermee geeft u een locatie.
Type: | String |
Position: | 3 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LogicalSectorSize
Grootte van logische sector in bytes voor Ultra-schijven.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MaxSharesCount
Het maximum aantal virtuele machines dat tegelijkertijd aan de schijf kan worden gekoppeld. De waarde groter dan één geeft een schijf aan die tegelijkertijd op meerdere VM's kan worden gekoppeld.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NetworkAccessPolicy
Netwerktoegangsbeleid definieert het netwerktoegangsbeleid. Mogelijke waarden zijn: 'AllowAll', 'AllowPrivate', 'DenyAll'
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OptimizedForFrequentAttach
Als u deze eigenschap instelt op waar, verbetert u de betrouwbaarheid en prestaties van gegevensschijven die vaak (meer dan 5 keer per dag) worden uitgevoerd door los te koppelen van de ene virtuele machine en gekoppeld aan een andere. Deze eigenschap mag niet worden ingesteld voor schijven die niet vaak zijn losgekoppeld en gekoppeld, omdat de schijven niet overeenkomen met het foutdomein van de virtuele machine.
Type: | Nullable<T>[Boolean] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OsType
Hiermee geeft u het type besturingssysteem.
Type: | Nullable<T>[OperatingSystemTypes] |
Accepted values: | Windows, Linux |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PerformancePlus
Stel deze vlag in op True om een boost te krijgen op het prestatiedoel van de schijf die is geïmplementeerd, zie hier over het respectieve prestatiedoel. Deze vlag kan alleen worden ingesteld op de aanmaaktijd van de schijf en kan niet worden uitgeschakeld nadat deze is ingeschakeld.
Type: | Nullable<T>[Boolean] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PublicNetworkAccess
Beleid voor het beheren van export op de schijf.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PurchasePlan
Hiermee geeft u het aankoopplan voor de schijf.
Type: | PSPurchasePlan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SkuName
Hiermee geeft u de SKU-naam van het opslagaccount. Beschikbare waarden zijn Standard_LRS, Premium_LRS, StandardSSD_LRS en UltraSSD_LRS, Premium_ZRS en StandardSSD_ZRS. UltraSSD_LRS kan alleen worden gebruikt met de lege waarde voor de parameter CreateOption.
Type: | String |
Aliases: | AccountType |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SourceResourceId
Hiermee geeft u de bronresource-id op.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SourceUri
Hiermee geeft u de bron-URI.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageAccountId
Hiermee geeft u de opslagaccount-id op.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SupportsHibernation
Klanten kunnen de vlag SupportsHibernation instellen op de schijf.
Type: | Nullable<T>[Boolean] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tag
Sleutel-waardeparen in de vorm van een hash-tabel. Bijvoorbeeld: @{key0="value0"; key1=$null; key2="value2"}
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tier
Prestatielaag van de schijf.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UploadSizeInBytes
Hiermee geeft u de grootte van de inhoud van de upload, inclusief de VHD-voettekst wanneer CreateOption is Geüpload. Deze waarde moet tussen 20972032 (20 MiB + 512 bytes voor de VHD-voettekst) en 35183298347520 bytes (32 TiB + 512 bytes voor de VHD-voettekst).
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Zone
Hiermee geeft u de lijst met logische zones voor Schijf.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Invoerwaarden
Nullable<T>[[Microsoft.Azure.Management.Compute.Models.OperatingSystemTypes, Microsoft.Azure.Management.Compute, Version=23.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]
String[]
Nullable<T>[[System.Boolean, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
Uitvoerwaarden
Azure PowerShell
Feedback
https://aka.ms/ContentUserFeedback.
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie:Feedback verzenden en weergeven voor