New-PmemDisk

  • Reference
Module:
PersistentMemory

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

Object