New-SpacesVolume
New-SpacesVolume
Creates a storage space and then creates and formats a volume on the storage space.
Sintaxis
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>]
Descripción detallada
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.
Parámetros
-ClusterSize<String>
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
9 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-CreateClusterSharedVolume
Creates a CSV on the volume.
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
10 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-DriveLetterToUse<Char>
Specifies the drive letter to assign to the storage space.
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
6 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
True (ByValue, ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-FileSystem<String>
Specifies the file system to use on the volume. Acceptable values are NTFS and ReFS.
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
11 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-InterleaveBytes<UInt64>
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
8 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-MaximumColumnCount
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
7 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-ProvisioningType<String>
Specifies whether to create a fixed or thinly provisioned storage space. Acceptable values are Fixed or Thin.
Alias |
ninguno |
¿Requerido? |
true |
¿Posición? |
5 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-ResiliencyType<String>
Specifies the resiliency setting to use. Acceptable values are Mirror, Parity, and Simple, which does not include any resiliency.
Alias |
ninguno |
¿Requerido? |
true |
¿Posición? |
4 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Size<String>
Specifies the size of the storage space.
Alias |
ninguno |
¿Requerido? |
true |
¿Posición? |
3 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-SpaceFriendlyName<String>
Specifies the friendly name of the storage space.
Alias |
ninguno |
¿Requerido? |
true |
¿Posición? |
2 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-StoragePoolFriendlyName<String>
Specifies the friendly name of the storage pool on which to create the storage space.
Alias |
ninguno |
¿Requerido? |
true |
¿Posición? |
1 |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Confirm
Solicita confirmación antes de ejecutar el cmdlet.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
falso |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
falso |
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los siguientes parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entradas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet.
- None
Salidas
El tipo de resultado es el tipo de objetos que emite el cmdlet.
System.Object
This cmdlet returns an object that contains information about the storage space and the volume hosted on the storage space.
Ejemplos
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