次の方法で共有

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>]

説明

New-AzRmStorageShare コマンドレットは、ストレージ ファイル共有を作成します。

例

例 1: ストレージ アカウント名と共有名を持つストレージ ファイル共有を作成し、メタデータと共有クォータを 100 GiB として作成します。

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

このコマンドは、メタデータを使用してストレージ ファイル共有を作成し、共有クォータを 100 GiB として作成します。

例 2: ストレージ アカウント オブジェクトを使用してストレージ ファイル共有を作成する

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

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

このコマンドは、ストレージ アカウント オブジェクトと共有名を使用してストレージ ファイル共有を作成します。

例 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 をホットとして使用してストレージ ファイル共有を作成します。

例 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 を持つストレージ ファイル共有を作成します。これは、Files Provisioned v2 アカウントの種類でのみ機能します。

例 7: 有料バースト帯域幅と IOPS を使用してストレージ ファイル共有を作成する

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

このコマンドは、有料バースト帯域幅と IOPS を使用してストレージ ファイル共有を作成します。これは Files Provisioned v1 アカウントの種類でのみ機能します。

パラメーター

-AccessTier

特定の共有のアクセス層。 StorageV2 アカウントでは、TransactionOptimized (既定)、ホット、クールを選択できます。 FileStorage アカウントでは、Premium を選択できます。

型:String
指定可能な値:TransactionOptimized, Premium, Hot, Cool
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

型:SwitchParameter
Aliases:cf
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション。

型:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EnabledProtocol

ファイル共有のプロトコルを設定します。 ファイル共有の作成後に変更することはできません。 使用可能な値は、'SMB'、'NFS' です。

型:String
指定可能な値:NFS, SMB
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Metadata

メタデータの共有

型:Hashtable
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

Azure ファイル共有名

型:String
Aliases:N, ShareName
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PaidBurstingEnabled

共有に対して有料バーストが有効かどうかを示します。 このプロパティは、Files Provisioned v1 SSD アカウントの種類で作成されたファイル共有に対してのみ使用されます。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PaidBurstingMaxBandwidthMibps

共有の最大有料バースト帯域幅 (1 秒あたりのメビバイト単位)。 このプロパティは、Files Provisioned v1 SSD アカウントの種類で作成されたファイル共有に対してのみ使用されます。 許容される最大値は 10340 です。これは、共有で許可される最大帯域幅です。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PaidBurstingMaxIops

共有の最大有料バースト IOPS。 このプロパティは、Files Provisioned v1 SSD アカウントの種類で作成されたファイル共有に対してのみ使用されます。 許可される最大値は 102400 です。これは、共有で許可される最大 IOPS です。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ProvisionedBandwidthMibps

共有のプロビジョニングされた帯域幅 (1 秒あたりメビバイト単位)。 このプロパティは、Files Provisioned v2 アカウントの種類で作成されたファイル共有に対してのみ使用されます。 プロビジョニングされた帯域幅の最小値と最大値については、Get-AzStorageFileServiceUsage コマンドレットの出力を参照してください。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ProvisionedIops

共有のプロビジョニングされた IOPS。 このプロパティは、Files Provisioned v2 アカウントの種類で作成されたファイル共有に対してのみ使用されます。 プロビジョニングされた IOPS の最小値と最大値については、Get-AzStorageFileServiceUsage コマンドレットの出力を参照してください。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-QuotaGiB

ギビバイトでクォータを共有します。

型:Int32
Aliases:Quota
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ResourceGroupName

リソース グループ名。

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RootSquash

リモート スーパーユーザーのアクセス権の削減を設定します。 使用可能な値は、'NoRootSquash'、'RootSquash'、'AllSquash' です。

型:String
指定可能な値:NoRootSquash, RootSquash, AllSquash
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Snapshot

同じ名前の既存の共有のスナップショットを作成します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-StorageAccount

ストレージ アカウント オブジェクト

型:PSStorageAccount
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-StorageAccountName

ストレージ アカウント名。

型:String
Aliases:AccountName
配置:1
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

出力