New-Datastore

This cmdlet creates a new datastore based on the provided parameters. The following characters cannot be used in a datastore name: slash (/), backslash (\), and percent (%).

Syntax

[-Name]  <String>
-NfsHost  <String[]>
-Path  <String>
-VMHost  <VMHost>
[-FileSystemVersion  <String>]
[-Kerberos]
[-Nfs]
[-ReadOnly]
[-Server  <VIServer[]>]
[CommonParameters]

Parameters

Required Parameter Name Type Position Features Description
required
Name
String 1 Specifies a name for the new datastore.
required
NfsHost
String[] named Specifies the NFS host where you want to create the new datastore.
required
Path
String named If you want to create an NFS datastore, specify the remote path of the NFS mount point. If you want to create a VMFS datastore, specify the canonical name of the SCSI logical unit that will contain new VMFS datastores.
required
VMHost
VMHost named
  • wildcards
  • pipeline
  • Specifies a host where you want to create the new datastore. Passing multiple values to this parameter is obsolete.
    optional
    FileSystemVersion
    String named Specifies the file system you want to use on the new datastore.
    optional
    Kerberos
    SwitchParameter named By default, NFS datastores are created with AUTH_SYS as the authentication protocol. This parameter indicates that the NFS datastore uses Kerberos version 5 for authentication. This parameter is available only for NFS version 4.1 datastores.
    optional
    Nfs
    SwitchParameter named Indicates that you want to create an NFS datastore.
    optional
    ReadOnly
    SwitchParameter named Indicates that the access mode for the mount point is ReadOnly. The default access mode is ReadWrite.
    optional
    Server
    VIServer[] named
  • wildcards
  • Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer.

    [-Name]  <String>
    -Path  <String>
    -VMHost  <VMHost>
    [-BlockSizeMB  <Int32>]
    [-FileSystemVersion  <String>]
    [-Server  <VIServer[]>]
    [-Vmfs]
    [CommonParameters]

    Parameters

    Required Parameter Name Type Position Features Description
    required
    Name
    String 1 Specifies a name for the new datastore.
    required
    Path
    String named If you want to create an NFS datastore, specify the remote path of the NFS mount point. If you want to create a VMFS datastore, specify the canonical name of the SCSI logical unit that will contain new VMFS datastores.
    required
    VMHost
    VMHost named
  • wildcards
  • pipeline
  • Specifies a host where you want to create the new datastore. Passing multiple values to this parameter is obsolete.
    optional
    BlockSizeMB
    Int32 named Specifies the maximum file size of VMFS in megabytes (MB). If no value is given, the maximum file size for the current system platform is used.
    optional
    FileSystemVersion
    String named Specifies the file system you want to use on the new datastore.
    optional
    Server
    VIServer[] named
  • wildcards
  • Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is provided or $null value is passed to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer.
    optional
    Vmfs
    SwitchParameter named Indicates that you want to create a VMFS datastore.

    Output

    VMware.VimAutomation.ViCore.Types.V1.DatastoreManagement.Datastore

    Examples


    Example 1

    New-Datastore -VMHost $vmhost -Name Datastore -Path $scsiLun.CanonicalName -Vmfs -FileSystemVersion 3

    Creates a VMFS datastore by specifying the file system type.

    Example 2

    New-Datastore -Nfs -VMHost 10.23.112.60 -Name NFSDatastore -Path /mynfs -NfsHost 10.23.84.73

    Creates a NFS datastore.

    Example 3

    $vmhost1, $vmhost2 | New-Datastore -Nfs -Name NFS1 -Path "/mnt/nfs1/nfs11/test1" -NfsHost 10.23.113.55 -ReadOnly

    Creates a read-only NFS datastore across multiple virtual machine hosts.

    Related Commands

    Feedback

    Was this page helpful?