Partilhar via

New-SCStorageFileShare

  • Referência
Módulo:
VirtualMachineManager

Cria um compartilhamento de arquivos de armazenamento no VMM.

Sintaxe

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 Virtual Machine Manager (VMM).

Exemplos

Exemplo 1: Criar um compartilhamento de arquivos 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 arquivos de armazenamento chamado FileServer01 e armazena o objeto na variável $FileServer.

O segundo comando cria um compartilhamento de arquivos de armazenamento chamado FileShare02 no FileServer01.

Exemplo 2: Criar um compartilhamento de arquivos de armazenamento hierárquico 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 $StorageClassification

O primeiro comando obtém o objeto de servidor de arquivos 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, em seguida, armazena-o 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 o compartilhamento de arquivos em camadas chamado FileShare01. O comando usa valores criados em comandos anteriores.

Exemplo 3: Criar um compartilhamento de arquivos de armazenamento hierárquico 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 arquivos 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, em seguida, armazena-o na variável $StoragePool. Este é 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 o compartilhamento de arquivos em camadas chamado FileShare01. O comando usa valores criados em comandos anteriores.

Parâmetros

-AllocationUnitSizeKB

Especifica o tamanho de alocação de um volume, em kilobytes.

Tipo:UInt32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ContinuouslyAvailable

Indica se o compartilhamento de arquivos está disponível continuamente.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DedupMode

Aplique a desduplicação no volume ou compartilhamento de arquivos com base na carga de trabalho. Os valores aceitáveis para este parâmetro são:

  • 0 - Deficientes
  • 1 - Finalidade Geral
  • 2 - Hyper-V
  • 3 - Backup
Tipo:DedupMode
Valores aceites:Disabled, GeneralPurpose, HyperV, Backup, NotAvailable
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Description

Especifica uma descrição para o compartilhamento de arquivos de armazenamento.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-FileSystem

Especifica o sistema de arquivos de um volume de armazenamento. Os valores aceitáveis para este parâmetro são:

  • CSVFS_NTFS
  • CSVFS_ReFS
Tipo:String
Valores aceites:CSVFS_NTFS, CSVFS_ReFS
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-HostedStoragePool

Especifica um pool de armazenamento hospedado.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-JobGroup

Especifica um identificador para uma série de comandos que serão executados como um conjunto imediatamente antes da execução do comando final que inclui o mesmo identificador de grupo de trabalhos.

Tipo:Guid
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-JobVariable

Especifica que o progresso do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-LocalPath

Especifica um caminho local para um compartilhamento de arquivos de armazenamento.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MediaType

Especifica uma matriz de objetos de tipo de mídia de disco físico de armazenamento.

Tipo:StoragePhysicalDiskMediaType[]
Valores aceites:Unknown, HDD, SSD
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica o nome de um objeto do VMM.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-NumberOfColumns

Especifica o número de colunas para um disco virtual.

Tipo:UInt16
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PhysicalDiskRedundancy

Especifica o número de falhas de disco físico que um disco virtual pode suportar.

Tipo:UInt16
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PROTipID

Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ReadCacheSizeMB

Tipo:UInt64
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ResiliencySettingName

Especifica a configuração de resiliência para um disco virtual. Os valores aceitáveis para este parâmetro são:

  • Simples
  • Espelho
  • Paridade
Tipo:String
Valores aceites:Simple, Mirror, Parity
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SizeMB

Especifica o tamanho, em megabytes, de um compartilhamento de arquivos de armazenamento.

Tipo:UInt64
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-StorageClassification

Especifica um objeto de classificação de armazenamento.

Tipo:StorageClassification
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-StorageFileServer

Especifica um objeto de servidor de arquivos de armazenamento.

Tipo:StorageFileServer
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-StoragePool

Especifica um objeto de pool de armazenamento.

Tipo:StoragePool
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-StorageTierSizeMB

Especifica, em MB, o tamanho da camada de armazenamento.

Tipo:UInt64[]
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-StorageVolume

Especifica um objeto de volume de armazenamento em um host de máquina virtual específico.

Tipo:StorageVolume
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VMMServer

Especifica um objeto de servidor VMM.

Tipo:ServerConnection
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False