New-PmemDisk
Creates a persistent memory disk in an unused persistent memory region.
Syntax
New-PmemDisk
-RegionId <UInt32[]>
[-FriendlyName <String[]>]
[-DiskSizeInBytes <UInt64[]>]
[-AtomicityType <NAMESPACE_ATOMICITY_TYPE[]>]
[<CommonParameters>]
New-PmemDisk
-DiskSizeInBytes <UInt64[]>
[-AtomicityType <NAMESPACE_ATOMICITY_TYPE[]>]
[-Simulated]
[<CommonParameters>]
Description
The New-PmemDisk cmdlet creates a persistent memory disk in an unused persistent memory region. A persistent memory is a contiguously addressed range of non-volatile memory. You can think of it as a hard disk partition or LUN.
The cmdlet can also create a simulated persistent memory disk that isn't in persistent memory.
Examples
Example 1: Create a disk
New-PmemDisk -RegionId 1 -AtomicityType BlockTranslationTable
This example creates a disk in the specified persistent memory region. The disk uses a block transfer table.
Example 2: Create a simulated persistent memory disk
New-PmemDisk -DiskSizeInBytes 270582939648 -Simulated
This example creates a simulated persistent memory disk of the specified size.
Example 3: Create multiple disks
Get-PmemUnusedRegion | New-PmemDisk
This example gets an unused persistent memory region. The command creates multiple persistent memory disks in the unused regions.
Parameters
-AtomicityType
Specifies whether to use a block translation table. A block translation table enables block-like sector writes. Applications can avoid mixing old and new data in a failure scenario.
Valid values are None
and BlockTranslationTable
. The default value is None
.
You can't change the atomicity type after you create a disk.
We strongly recommend BlockTranslationTable
in nearly all cases.
Type: | NAMESPACE_ATOMICITY_TYPE[] |
Accepted values: | None, BlockTranslationTable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DiskSizeInBytes
Specifies the size of the persistent memory disk.
Type: | UInt64[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FriendlyName
Specifies a friendly name for the persistent memory disk.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RegionId
Specifies the ID of the region for the persistent memory disk.
Type: | UInt32[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Simulated
Indicates that the command creates a simulated persistent memory disk. You can create a simulated disk without persistent memory hardware.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
UInt32[]
Outputs
Related Links
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour