New-SCStorageFileShare
Cria um compartilhamento de arquivo de armazenamento no VMM.
Syntax
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
O cmdlet New-SCStorageFileShare cria um compartilhamento de arquivos de armazenamento no VMM (Virtual Machine Manager).
Exemplos
Exemplo 1: Criar um compartilhamento de arquivo de armazenamento
PS C:\> $FileServer = Get-SCStorageFileServer -Name "FileServer01.Contoso.com"
PS C:\> New-SCStorageFileShare -Name "FileShare02" -StorageFileServer $FileServer -LocalPath "C:\FileShare02"O primeiro comando obtém o objeto de servidor de arquivo de armazenamento chamado FileServer01 e armazena o objeto na variável $FileServer.
O segundo comando cria um compartilhamento de arquivo de armazenamento chamado FileShare02 no FileServer01.
Exemplo 2: Criar um compartilhamento de arquivo de armazenamento em camadas em um SOFS compartilhado
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 $StorageClassificationO primeiro comando obtém o objeto de servidor de arquivo de armazenamento chamado FileServer01 e, em seguida, armazena-o na variável $FileServer.
O segundo comando obtém o pool de armazenamento chamado Pool01 e o armazena na variável $StoragePool.
O terceiro e quarto comandos criam camadas de armazenamento.
O quinto comando obtém a classificação de armazenamento chamada Gold e, em seguida, armazena-a na variável $StorageClassification.
O último comando cria um compartilhamento de arquivo em camadas chamado FileShare01. O comando usa valores criados em comandos anteriores.
Exemplo 3: Criar um compartilhamento de arquivo de armazenamento em camadas em um 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"O primeiro comando obtém o objeto de servidor de arquivo de armazenamento chamado FileServer01 e, em seguida, armazena-o na variável $FileServer.
O segundo comando obtém o pool de armazenamento chamado S2DPool01 e o armazena na variável $StoragePool. Esse é um pool direto de espaços de armazenamento.
O terceiro e quarto comandos criam camadas de armazenamento.
O quinto comando obtém a classificação de armazenamento chamada Gold e, em seguida, armazena-a na variável $StorageClassification.
O último comando cria um compartilhamento de arquivo em camadas chamado FileShare01. O comando usa valores criados em comandos anteriores.
Parâmetros
-AllocationUnitSizeKB
Especifica o tamanho da alocação de um volume, em quilobytes.
| Type: | UInt32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ContinuouslyAvailable
Indica se o compartilhamento de arquivos está disponível continuamente.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DedupMode
Aplique a eliminação de duplicação no volume ou compartilhamento de arquivos com base na carga de trabalho. Os valores aceitáveis para esse parâmetro são:
- 0 - Desabilitado
- 1 – GeneralPurpose
- 2 – Hyper-V
- 3 – Backup
| Type: | DedupMode |
| Accepted values: | Disabled, GeneralPurpose, HyperV, Backup, NotAvailable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Especifica uma descrição para o compartilhamento de arquivos de armazenamento.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FileSystem
Especifica o sistema de arquivos de um volume de armazenamento. Os valores aceitáveis para esse parâmetro são:
- CSVFS_NTFS
- CSVFS_ReFS
| Type: | String |
| Accepted values: | CSVFS_NTFS, CSVFS_ReFS |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HostedStoragePool
Especifica um pool de armazenamento hospedado.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobGroup
Especifica um identificador para uma série de comandos que serão executados como um conjunto pouco antes do comando final que inclui o mesmo identificador de grupo de trabalho ser executado.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Especifica que o andamento do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LocalPath
Especifica um caminho local para um compartilhamento de arquivos de armazenamento.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MediaType
Especifica uma matriz de objetos de tipo de mídia de disco físico de armazenamento.
| Type: | StoragePhysicalDiskMediaType[] |
| Accepted values: | Unknown, HDD, SSD |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Especifica o nome de um objeto do VMM.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NumberOfColumns
Especifica o número de colunas para um disco virtual.
| Type: | UInt16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PhysicalDiskRedundancy
Especifica o número de falhas de disco físico que um disco virtual pode sustentar.
| Type: | UInt16 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReadCacheSizeMB
| Type: | UInt64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResiliencySettingName
Especifica a configuração de resiliência de um disco virtual. Os valores aceitáveis para esse parâmetro são:
- Simples
- Espelho
- Parity
| Type: | String |
| Accepted values: | Simple, Mirror, Parity |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne imediatamente ao shell de comando.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SizeMB
Especifica o tamanho, em megabytes, de um compartilhamento de arquivo de armazenamento.
| Type: | UInt64 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageClassification
Especifica um objeto de classificação de armazenamento.
| Type: | StorageClassification |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageFileServer
Especifica um objeto de servidor de arquivo de armazenamento.
| Type: | StorageFileServer |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StoragePool
Especifica um objeto de pool de armazenamento.
| Type: | StoragePool |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageTierSizeMB
Especifica, em MB, o tamanho da camada de armazenamento.
| Type: | UInt64[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageVolume
Especifica um objeto de volume de armazenamento em um host de máquina virtual específico.
| Type: | StorageVolume |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Especifica um objeto de servidor do VMM.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |