New-PmemDisk
Creates a persistent memory disk in an unused persistent memory region.
Syntax
NormalDisk
New-PmemDisk
-RegionId <UInt32[]>
[-FriendlyName <String[]>]
[-DiskSizeInBytes <UInt64[]>]
[-AtomicityType <NAMESPACE_ATOMICITY_TYPE[]>]
[<CommonParameters>]
SimulatedDisk
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.
Parameter properties
| Type: | NAMESPACE_ATOMICITY_TYPE[] |
| Default value: | None |
| Accepted values: | None, BlockTranslationTable |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-DiskSizeInBytes
Specifies the size of the persistent memory disk.
Parameter properties
| Type: | UInt64[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-FriendlyName
Specifies a friendly name for the persistent memory disk.
Parameter properties
| Type: | String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
NormalDisk
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-RegionId
Specifies the ID of the region for the persistent memory disk.
Parameter properties
| Type: | UInt32[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
NormalDisk
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-Simulated
Indicates that the command creates a simulated persistent memory disk. You can create a simulated disk without persistent memory hardware.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
SimulatedDisk
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.