New-AzRmStorageShare

참조

모듈:: Az.Storage

스토리지 파일 공유를 만듭니다.

구문

New-AzRmStorageShare
   [-ResourceGroupName] <String>
   [-StorageAccountName] <String>
   -Name <String>
   [-QuotaGiB <Int32>]
   [-Metadata <Hashtable>]
   [-AccessTier <String>]
   [-Snapshot]
   [-EnabledProtocol <String>]
   [-RootSquash <String>]
   [-ProvisionedBandwidthMibps <Int32>]
   [-ProvisionedIops <Int32>]
   [-PaidBurstingEnabled]
   [-PaidBurstingMaxIops <Int32>]
   [-PaidBurstingMaxBandwidthMibps <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzRmStorageShare
   -StorageAccount <PSStorageAccount>
   -Name <String>
   [-QuotaGiB <Int32>]
   [-Metadata <Hashtable>]
   [-AccessTier <String>]
   [-Snapshot]
   [-EnabledProtocol <String>]
   [-RootSquash <String>]
   [-ProvisionedBandwidthMibps <Int32>]
   [-ProvisionedIops <Int32>]
   [-PaidBurstingEnabled]
   [-PaidBurstingMaxIops <Int32>]
   [-PaidBurstingMaxBandwidthMibps <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

New-AzRmStorageShare cmdlet은 스토리지 파일 공유를 만듭니다.

예제

예제 1: 메타데이터 및 공유 할당량을 100GiB로 사용하여 Storage 계정 이름 및 공유 이름을 사용하여 Storage 파일 공유를 만듭니다.

New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -QuotaGiB 100 -Metadata @{"tag1" = "value1"; "tag2" = "value2" }

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocol AccessTier Deleted Version ShareUsageBytes
----     -------- --------------- ---------- ------- ------- ---------------
myshare

이 명령은 메타데이터를 사용하여 스토리지 파일 공유를 만들고 할당량을 100GiB로 공유합니다.

예제 2: Storage 계정 개체를 사용하여 Storage 파일 공유 만들기

Get-AzStorageAccount -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" | New-AzRmStorageShare -Name "myshare"

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocol AccessTier Deleted Version ShareUsageBytes
----     -------- --------------- ---------- ------- ------- ---------------
myshare

이 명령은 Storage 계정 개체 및 공유 이름을 사용하여 Storage 파일 공유를 만듭니다.

예제 3: accesstier를 핫으로 사용하여 스토리지 파일 공유 만들기

$share = New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -AccessTier Hot

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
myshare                            Hot

이 명령은 accesstier를 핫으로 사용하여 Storage 파일 공유를 만듭니다.

예제 4: 기존 공유의 스토리지 파일 공유 스냅샷 만들기

$shareSnapshot = New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -Snapshot

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes snapshotTime 
----     -------- ---------------- ---------- ------- ------- --------------- ------------   
myshare                                                                       2021-05-10T08:04:08

이 명령은 기존 기본 파일 공유의 스토리지 파일 공유 스냅샷을 만듭니다.

예제 5: EnabledProtocol proeprty를 NFS로, RootSquash 속성을 NoRootSquash로 사용하여 스토리지 파일 공유 만들기

$share = New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -EnabledProtocol NFS -RootSquash NoRootSquash 

$share

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
myshare           NFS

$share.RootSquash
NoRootSquash

이 명령은 EnabledProtocol proeprty를 NFS로, RootSquash proeprty를 NoRootSquash로 사용하여 스토리지 파일 공유를 만듭니다.

예제 6: 프로비전된 대역폭 및 IOPS를 사용하여 스토리지 파일 공유 만들기

New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -ProvisionedBandwidthMibps 129 -ProvisionedIops 3032

이 명령은 프로비전된 대역폭 및 IOPS를 사용하여 Storage 파일 공유를 만듭니다. 이 공유는 Files Provisioned v2 계정 유형에서만 작동합니다.

예제 7: 유료 버스트 대역폭 및 IOPS를 사용하여 스토리지 파일 공유 만들기

New-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -PaidBurstingEnabled -PaidBurstingMaxBandwidthMibps 129 -PaidBurstingMaxIops 3032

이 명령은 유료 버스팅 대역폭 및 IOPS를 사용하여 Storage 파일 공유를 만듭니다. 파일 프로비전된 v1 계정 유형에서만 작동합니다.

매개 변수

-AccessTier

특정 공유에 대한 액세스 계층입니다. StorageV2 계정은 TransactionOptimized(기본값), 핫 및 쿨 중에서 선택할 수 있습니다. FileStorage 계정은 프리미엄을 선택할 수 있습니다.

형식:	String
허용되는 값:	TransactionOptimized, Premium, Hot, Cool
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

형식:	SwitchParameter
별칭:	cf
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:	IAzureContextContainer
별칭:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-EnabledProtocol

파일 공유에 대한 프로토콜을 설정합니다. 파일 공유를 만든 후에는 변경할 수 없습니다. 가능한 값은 'SMB', 'NFS'입니다.

형식:	String
허용되는 값:	NFS, SMB
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Metadata

메타데이터 공유

형식:	Hashtable
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Name

Azure 파일 공유 이름

형식:	String
별칭:	N, ShareName
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-PaidBurstingEnabled

공유에 대해 유료 버스팅을 사용할 수 있는지 여부를 나타냅니다. 이 속성은 Files Provisioned v1 SSD 계정 유형에서 만든 파일 공유에만 해당합니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-PaidBurstingMaxBandwidthMibps

공유에 대한 최대 유료 버스트 대역폭(초당 mebibytes)입니다. 이 속성은 Files Provisioned v1 SSD 계정 유형에서 만든 파일 공유에만 해당합니다. 허용되는 최대 값은 공유에 허용되는 최대 대역폭인 10340입니다.

형식:	Int32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-PaidBurstingMaxIops

공유에 대한 최대 유료 버스트 IOPS입니다. 이 속성은 Files Provisioned v1 SSD 계정 유형에서 만든 파일 공유에만 해당합니다. 허용되는 최대값은 공유에 허용되는 최대 IOPS인 102400입니다.

형식:	Int32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ProvisionedBandwidthMibps

공유의 프로비전된 대역폭(초당 mebibytes)입니다. 이 속성은 Files Provisioned v2 계정 유형에서 만든 파일 공유에만 해당합니다. 프로비전된 대역폭에 허용되는 최소값과 최대값은 Get-AzStorageFileServiceUsage cmdlet 출력을 참조하세요.

형식:	Int32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ProvisionedIops

공유의 프로비전된 IOPS입니다. 이 속성은 Files Provisioned v2 계정 유형에서 만든 파일 공유에만 해당합니다. 프로비전된 IOPS에 허용되는 최소값과 최대값은 Get-AzStorageFileServiceUsage cmdlet 출력을 참조하세요.

형식:	Int32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-QuotaGiB

Gibibyte에서 할당량을 공유합니다.

형식:	Int32
별칭:	Quota
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ResourceGroupName

리소스 그룹 이름입니다.

형식:	String
Position:	0
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-RootSquash

원격 슈퍼 사용자에 대한 액세스 권한의 감소를 설정합니다. 가능한 값은 'NoRootSquash', 'RootSquash', 'AllSquash'입니다.

형식:	String
허용되는 값:	NoRootSquash, RootSquash, AllSquash
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Snapshot

이름이 같은 기존 공유의 스냅샷을 만듭니다.

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-StorageAccount

Storage 계정 개체

형식:	PSStorageAccount
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	True
와일드카드 문자 허용:	False

-StorageAccountName

스토리지 계정 이름입니다.

형식:	String
별칭:	AccountName
Position:	1
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

형식:	SwitchParameter
별칭:	wi
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

String

PSStorageAccount

출력

PSShare

다음을 통해 공유