New-SpacesVolume
New-SpacesVolume
Creates a storage space and then creates and formats a volume on the storage space.
Syntaxe
Parameter Set: Default
New-SpacesVolume [-StoragePoolFriendlyName] <String> [-SpaceFriendlyName] <String> [-Size] <String> [-ResiliencyType] <String> [-ProvisioningType] <String> [[-DriveLetterToUse] <Char> ] [[-MaximumColumnCount]] [[-InterleaveBytes] <UInt64> ] [[-ClusterSize] <String> ] [[-CreateClusterSharedVolume]] [[-FileSystem] <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Description détaillée
The New-SpacesVolume cmdlet creates a storage space, initializes the new virtual disk (storage space), creates a partition on virtual disk, and then formats the volume. It can also optionally create a Cluster Shared Volume (CSV) on the newly formatted volume when run on a failover cluster.
Paramètres
-ClusterSize<String>
Alias |
none |
Obligatoire ? |
false |
Position ? |
9 |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-CreateClusterSharedVolume
Creates a CSV on the volume.
Alias |
none |
Obligatoire ? |
false |
Position ? |
10 |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-DriveLetterToUse<Char>
Specifies the drive letter to assign to the storage space.
Alias |
none |
Obligatoire ? |
false |
Position ? |
6 |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
True (ByValue, ByPropertyName) |
Accepter les caractères génériques ? |
false |
-FileSystem<String>
Specifies the file system to use on the volume. Acceptable values are NTFS and ReFS.
Alias |
none |
Obligatoire ? |
false |
Position ? |
11 |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-InterleaveBytes<UInt64>
Alias |
none |
Obligatoire ? |
false |
Position ? |
8 |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-MaximumColumnCount
Alias |
none |
Obligatoire ? |
false |
Position ? |
7 |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-ProvisioningType<String>
Specifies whether to create a fixed or thinly provisioned storage space. Acceptable values are Fixed or Thin.
Alias |
none |
Obligatoire ? |
true |
Position ? |
5 |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-ResiliencyType<String>
Specifies the resiliency setting to use. Acceptable values are Mirror, Parity, and Simple, which does not include any resiliency.
Alias |
none |
Obligatoire ? |
true |
Position ? |
4 |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Size<String>
Specifies the size of the storage space.
Alias |
none |
Obligatoire ? |
true |
Position ? |
3 |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-SpaceFriendlyName<String>
Specifies the friendly name of the storage space.
Alias |
none |
Obligatoire ? |
true |
Position ? |
2 |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-StoragePoolFriendlyName<String>
Specifies the friendly name of the storage pool on which to create the storage space.
Alias |
none |
Obligatoire ? |
true |
Position ? |
1 |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Confirm
Votre confirmation sera requise avant l’exécution de l’applet de commande.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
false |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-WhatIf
Présente les conséquences éventuelles de l’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
false |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d’informations, consultez about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entrées
Le type d’entrée correspond au type des objets que vous pouvez transmettre à l’applet de commande.
- None
Sorties
Le type de sortie est le type des objets émis par l’applet de commande.
System.Object
This cmdlet returns an object that contains information about the storage space and the volume hosted on the storage space.
Exemples
Example 1 – Create a thinly provisioned mirror space
This example creates a storage space named Test, which is a thinly provisioned mirror space, and then creates and formats a volume on the storage space.
PS C:\> New-SpacesVolume -StoragePoolFriendlyName Internal -SpaceFriendlyName Test -Size (5GB) -ResiliencyType Mirror -ProvisioningType Thin
Example 2 – Create a thinly provisioned mirror space and assign a specific drive letter
This example creates a storage space named Test, which is a thinly provisioned mirror space, and then creates and formats an NTFS volume on the storage space, and assigns drive letter T to the volume.
PS C:\> New-SpacesVolume -StoragePoolFriendlyName Internal -SpaceFriendlyName Test -Size (5GB) -ResiliencyType Mirror -ProvisioningType Thin -DriveLetterToUse T -FileSystem NTFS
Example 3 – Create a fixed mirror space and create a Cluster Shared Volume
This example creates a 5GB mirror space, with fixed provisioning, and creates a Cluster Shared Volume (CSV) after creation. Note: Requires a clustered storage pool.
PS C:\> New-SpacesVolume -StoragePoolFriendlyName Internal -SpaceFriendlyName Test -Size (5GB) -ResiliencyType Mirror -ProvisioningType Fixed -CSV