New-SCStorageFileShare

Módulo:

VirtualMachineManager

Crea un recurso compartido de archivos de almacenamiento en VMM.

Sintaxis

New-SCStorageFileShare
   [-VMMServer <ServerConnection>]
   -StorageFileServer <StorageFileServer>
   -Name <String>
   [-Description <String>]
   -LocalPath <String>
   [-ContinuouslyAvailable <Boolean>]
   [-StorageClassification <StorageClassification>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCStorageFileShare
   [-VMMServer <ServerConnection>]
   -StorageFileServer <StorageFileServer>
   -Name <String>
   [-Description <String>]
   -StoragePool <StoragePool>
   [-FileSystem <String>]
   [-DedupMode <DedupMode>]
   [-AllocationUnitSizeKB <UInt32>]
   [-StorageClassification <StorageClassification>]
   [-ReadCacheSizeMB <UInt64>]
   -JobGroup <Guid>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCStorageFileShare
   [-VMMServer <ServerConnection>]
   -StorageFileServer <StorageFileServer>
   -Name <String>
   [-Description <String>]
   -StoragePool <StoragePool>
   [-FileSystem <String>]
   [-ResiliencySettingName <String>]
   [-NumberOfColumns <UInt16>]
   [-PhysicalDiskRedundancy <UInt16>]
   [-DedupMode <DedupMode>]
   [-AllocationUnitSizeKB <UInt32>]
   -SizeMB <UInt64>
   [-StorageClassification <StorageClassification>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCStorageFileShare
   [-VMMServer <ServerConnection>]
   -StorageFileServer <StorageFileServer>
   -Name <String>
   [-Description <String>]
   -StoragePool <StoragePool>
   [-FileSystem <String>]
   [-ResiliencySettingName <String>]
   [-NumberOfColumns <UInt16>]
   [-PhysicalDiskRedundancy <UInt16>]
   [-DedupMode <DedupMode>]
   [-AllocationUnitSizeKB <UInt32>]
   [-StorageClassification <StorageClassification>]
   -MediaType <StoragePhysicalDiskMediaType[]>
   -StorageTierSizeMB <UInt64[]>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCStorageFileShare
   [-VMMServer <ServerConnection>]
   -StorageFileServer <StorageFileServer>
   -Name <String>
   [-Description <String>]
   -StorageVolume <StorageVolume>
   [-StorageClassification <StorageClassification>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

New-SCStorageFileShare
   [-VMMServer <ServerConnection>]
   -StorageFileServer <StorageFileServer>
   -Name <String>
   [-Description <String>]
   -HostedStoragePool <String>
   -SizeMB <UInt64>
   [-StorageClassification <StorageClassification>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

El cmdlet New-SCStorageFileShare crea un recurso compartido de archivos de almacenamiento en Virtual Machine Manager (VMM).

Ejemplos

Ejemplo 1: Creación de un recurso compartido de archivos de almacenamiento

PS C:\> $FileServer = Get-SCStorageFileServer -Name "FileServer01.Contoso.com"
PS C:\> New-SCStorageFileShare -Name "FileShare02" -StorageFileServer $FileServer -LocalPath "C:\FileShare02"

El primer comando obtiene el objeto de servidor de archivos de almacenamiento denominado FileServer01 y almacena el objeto en la variable $FileServer.

El segundo comando crea un recurso compartido de archivos de almacenamiento denominado FileShare02 en FileServer01.

Ejemplo 2: Creación de un recurso compartido de archivos de almacenamiento en capas en un SOFS compartido

PS C:\> $FileServer = Get-SCStorageFileServer -Name "FileServer01.Contoso.com"
PS C:\> $StoragePool = Get-SCStoragePool -Name "Pool01"
PS C:\> New-SCStorageTier -MediaType "SSD" -SizeMB 1024  -PhysicalDiskRedundancy "2" -ResiliencySettingName "Mirror" -RunAsynchronously -JobGroup "2e42beba-fb19-4c15-94e6-64a54012dce3"
PS C:\> New-SCStorageTier -MediaType "HDD" -SizeMB 1024  -PhysicalDiskRedundancy "2" -ResiliencySettingName "Parity" -RunAsynchronously -JobGroup "2e42beba-fb19-4c15-94e6-64a54012dce3"
PS C:\> $StorageClassification = Get-SCStorageClassification -Name "Gold"
PS C:\> $StorageFileShare = New-SCStorageFileShare -StorageFileServer $FileServer -StoragePool $StoragePool -Name "FileShare01" -Description "shared SOSF" -RunAsynchronously -JobGroup "2e42beba-fb19-4c15-94e664a54012dce3" -FileSystem "CSVFS_ReFS" -StorageClassification $StorageClassification

El primer comando obtiene el objeto de servidor de archivos de almacenamiento denominado FileServer01 y, a continuación, lo almacena en la variable $FileServer.

El segundo comando obtiene el grupo de almacenamiento denominado Pool01 y, a continuación, lo almacena en la variable $StoragePool.

Los comandos tercero y cuarto crean niveles de almacenamiento.

El quinto comando obtiene la clasificación de almacenamiento denominada Gold y, a continuación, la almacena en la variable $StorageClassification.

El último comando crea un recurso compartido de archivos en capas denominado FileShare01. El comando usa valores creados en comandos anteriores.

Ejemplo 3: Creación de un recurso compartido de archivos de almacenamiento en capas en un sistema S2D

PS C:\> $FileServer = Get-SCStorageFileServer -Name "FileServer01.Contoso.com"
PS C:\> $StoragePool = Get-SCStoragePool -Name "S2DPool01"
PS C:\> New-SCStorageTier -StorageTierFriendlyName "Performance" -StorageTierSizeInMB 1024 -RunAsynchronously -JobGroup "2e42beba-fb19-4c15-94e6-64a54012dce3"
PS C:\> New-SCStorageTier -StorageTierFriendlyName "Capacity" -StorageTierSizeInMB 1024 -RunAsynchronously -JobGroup "2e42beba-fb19-4c15-94e6-64a54012dce3"
PS C:\> $StorageClassification = Get-SCStorageClassification -Name "Gold"
PS C:\> $StorageFileShare = New-SCStorageFileShare -StorageFileServer $FileServer -StoragePool $StoragePool -Name "FileShare01" -Description "storage spaces direct config" -RunAsynchronously -JobGroup "2e42beba-fb19-4c15-94e664a54012dce3" -FileSystem "CSVFS_ReFS" -StorageClassification $StorageClassification"

El primer comando obtiene el objeto de servidor de archivos de almacenamiento denominado FileServer01 y, a continuación, lo almacena en la variable $FileServer.

El segundo comando obtiene el grupo de almacenamiento denominado S2DPool01 y, a continuación, lo almacena en la variable $StoragePool. Se trata de un grupo de espacios de almacenamiento directo.

Los comandos tercero y cuarto crean niveles de almacenamiento.

El quinto comando obtiene la clasificación de almacenamiento denominada Gold y, a continuación, la almacena en la variable $StorageClassification.

El último comando crea un recurso compartido de archivos en capas denominado FileShare01. El comando usa valores creados en comandos anteriores.

Parámetros

-AllocationUnitSizeKB

Especifica el tamaño de asignación de un volumen, en kilobytes.

Tipo:	UInt32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ContinuouslyAvailable

Indica si el recurso compartido de archivos está disponible de forma continua.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DedupMode

Aplique la desduplicación en el volumen o recurso compartido de archivos en función de la carga de trabajo. Los valores aceptables para este parámetro son:

• 0 - Deshabilitado
• 1 - GeneralPurpose
• 2 - Hyper-V
• 3 - Copia de seguridad

Tipo:	DedupMode
Valores aceptados:	Disabled, GeneralPurpose, HyperV, Backup, NotAvailable
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Description

Especifica una descripción para el recurso compartido de archivos de almacenamiento.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-FileSystem

Especifica el sistema de archivos de un volumen de almacenamiento. Los valores aceptables para este parámetro son:

• CSVFS_NTFS
• CSVFS_ReFS

Tipo:	String
Valores aceptados:	CSVFS_NTFS, CSVFS_ReFS
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-HostedStoragePool

Especifica un grupo de almacenamiento hospedado.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-JobGroup

Especifica un identificador para una serie de comandos que se ejecutarán como un conjunto justo antes de que se ejecute el mismo identificador de grupo de trabajos.

Tipo:	Guid
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y se almacena en la variable denominada por este parámetro.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-LocalPath

Especifica una ruta de acceso local para un recurso compartido de archivos de almacenamiento.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-MediaType

Especifica una matriz de objetos de tipo multimedia de disco físico de almacenamiento.

Tipo:	StoragePhysicalDiskMediaType[]
Valores aceptados:	Unknown, HDD, SSD
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Name

Especifica el nombre de un objeto VMM.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-NumberOfColumns

Especifica el número de columnas de un disco virtual.

Tipo:	UInt16
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PhysicalDiskRedundancy

Especifica el número de errores de disco físico que puede admitir un disco virtual.

Tipo:	UInt16
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PROTipID

Especifica el identificador de la sugerencia Sobre rendimiento y optimización de recursos (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias PRO.

Tipo:	Guid
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ReadCacheSizeMB

Tipo:	UInt64
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ResiliencySettingName

Especifica la configuración de resistencia de un disco virtual. Los valores aceptables para este parámetro son:

• Sencillo
• Espejo
• Paridad

Tipo:	String
Valores aceptados:	Simple, Mirror, Parity
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RunAsynchronously

Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-SizeMB

Especifica el tamaño, en megabytes, de un recurso compartido de archivos de almacenamiento.

Tipo:	UInt64
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-StorageClassification

Especifica un objeto de clasificación de almacenamiento.

Tipo:	StorageClassification
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-StorageFileServer

Especifica un objeto de servidor de archivos de almacenamiento.

Tipo:	StorageFileServer
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-StoragePool

Especifica un objeto de grupo de almacenamiento.

Tipo:	StoragePool
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-StorageTierSizeMB

Especifica, en MB, el tamaño del nivel de almacenamiento.

Tipo:	UInt64[]
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-StorageVolume

Especifica un objeto de volumen de almacenamiento en un host de máquina virtual específico.

Tipo:	StorageVolume
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-VMMServer

Especifica un objeto de servidor VMM.

Tipo:	ServerConnection
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

Vínculos relacionados

• Get-SCStorageFileShare
• Register-SCStorageFileShare
• Remove-SCStorageFileShare
• Repair-SCStorageFileShare
• Set-SCStorageFileShare
• Unregister-SCStorageFileShare