New-SCStorageFileShare

모듈:

VirtualMachineManager

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

New-SCStorageFileShare cmdlet은 VMM(Virtual Machine Manager)에서 스토리지 파일 공유를 만듭니다.

예제

예제 1: 스토리지 파일 공유 만들기

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

첫 번째 명령은 FileServer01이라는 스토리지 파일 서버 개체를 가져오고 개체를 $FileServer 변수에 저장합니다.

두 번째 명령은 FileServer01에 FileShare02라는 스토리지 파일 공유를 만듭니다.

예제 2: 공유 SOFS에서 계층화된 스토리지 파일 공유 만들기

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

첫 번째 명령은 FileServer01이라는 스토리지 파일 서버 개체를 가져오고 $FileServer 변수에 저장합니다.

두 번째 명령은 Pool01이라는 스토리지 풀을 가져오고 $StoragePool 변수에 저장합니다.

세 번째 및 네 번째 명령은 스토리지 계층을 만듭니다.

다섯 번째 명령은 Gold라는 스토리지 분류를 가져오고 $StorageClassification 변수에 저장합니다.

마지막 명령은 FileShare01이라는 계층화된 파일 공유를 만듭니다. 이 명령은 이전 명령에서 만든 값을 사용합니다.

예제 3: 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"

첫 번째 명령은 FileServer01이라는 스토리지 파일 서버 개체를 가져오고 $FileServer 변수에 저장합니다.

두 번째 명령은 S2DPool01이라는 스토리지 풀을 가져오고 $StoragePool 변수에 저장합니다. 스토리지 공간 직접 풀입니다.

세 번째 및 네 번째 명령은 스토리지 계층을 만듭니다.

다섯 번째 명령은 Gold라는 스토리지 분류를 가져오고 $StorageClassification 변수에 저장합니다.

마지막 명령은 FileShare01이라는 계층화된 파일 공유를 만듭니다. 이 명령은 이전 명령에서 만든 값을 사용합니다.

매개 변수

-AllocationUnitSizeKB

볼륨의 할당 크기(킬로바이트)를 지정합니다.

Type:	UInt32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContinuouslyAvailable

파일 공유를 지속적으로 사용할 수 있는지 여부를 나타냅니다.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DedupMode

워크로드에 따라 볼륨 또는 파일 공유에 중복 제거를 적용합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

• 0 - 사용 안 함
• 1 - GeneralPurpose
• 2 - Hyper-V
• 3 - 백업

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

스토리지 파일 공유에 대한 설명을 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FileSystem

스토리지 볼륨의 파일 시스템을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

• 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

호스트된 스토리지 풀을 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-JobGroup

동일한 작업 그룹 식별자를 포함하는 마지막 명령이 실행되기 직전에 하나의 집합으로 실행되는 일련의 명령에 대한 식별자를 지정합니다.

Type:	Guid
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-JobVariable

작업 진행률을 추적하여 이 매개 변수로 이름이 지정된 변수에 보관하도록 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LocalPath

스토리지 파일 공유에 대한 로컬 경로를 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-MediaType

스토리지 실제 디스크 미디어 형식 개체의 배열을 지정합니다.

Type:	StoragePhysicalDiskMediaType[]
Accepted values:	Unknown, HDD, SSD
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

VMM 개체의 이름을 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NumberOfColumns

가상 디스크의 열 수를 지정합니다.

Type:	UInt16
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PhysicalDiskRedundancy

가상 디스크가 유지할 수 있는 실제 디스크 오류 수를 지정합니다.

Type:	UInt16
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PROTipID

이 작업을 트리거한 PRO 팁(성능 및 리소스 최적화 팁)의 ID를 지정합니다. 이 매개 변수를 사용하면 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

가상 디스크에 대한 복원력 설정을 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

• 단순
• 미러
• Parity

Type:	String
Accepted values:	Simple, Mirror, Parity
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RunAsynchronously

컨트롤이 명령 셸로 즉시 반환되도록 작업이 비동기적으로 실행됨을 나타냅니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SizeMB

스토리지 파일 공유의 크기(MB)를 지정합니다.

Type:	UInt64
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-StorageClassification

스토리지 분류 개체를 지정합니다.

Type:	StorageClassification
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StorageFileServer

스토리지 파일 서버 개체를 지정합니다.

Type:	StorageFileServer
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-StoragePool

스토리지 풀 개체를 지정합니다.

Type:	StoragePool
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-StorageTierSizeMB

스토리지 계층 크기를 MB 단위로 지정합니다.

Type:	UInt64[]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-StorageVolume

특정 가상 머신 호스트의 스토리지 볼륨 개체를 지정합니다.

Type:	StorageVolume
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-VMMServer

VMM 서버 개체를 지정합니다.

Type:	ServerConnection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

관련 링크

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