次の方法で共有

Update-AzRmStorageShare

  • リファレンス
モジュール:
Az.Storage

ストレージ ファイル共有を変更します。

構文

Update-AzRmStorageShare
      [-ResourceGroupName] <String>
      [-StorageAccountName] <String>
      -Name <String>
      [-QuotaGiB <Int32>]
      [-Metadata <Hashtable>]
      [-AccessTier <String>]
      [-RootSquash <String>]
      [-ProvisionedBandwidthMibps <Int32>]
      [-ProvisionedIops <Int32>]
      [-PaidBurstingEnabled <Boolean>]
      [-PaidBurstingMaxIops <Int32>]
      [-PaidBurstingMaxBandwidthMibps <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzRmStorageShare
      -Name <String>
      -StorageAccount <PSStorageAccount>
      [-QuotaGiB <Int32>]
      [-Metadata <Hashtable>]
      [-AccessTier <String>]
      [-RootSquash <String>]
      [-ProvisionedBandwidthMibps <Int32>]
      [-ProvisionedIops <Int32>]
      [-PaidBurstingEnabled <Boolean>]
      [-PaidBurstingMaxIops <Int32>]
      [-PaidBurstingMaxBandwidthMibps <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzRmStorageShare
      [-ResourceId] <String>
      [-QuotaGiB <Int32>]
      [-Metadata <Hashtable>]
      [-AccessTier <String>]
      [-RootSquash <String>]
      [-ProvisionedBandwidthMibps <Int32>]
      [-ProvisionedIops <Int32>]
      [-PaidBurstingEnabled <Boolean>]
      [-PaidBurstingMaxIops <Int32>]
      [-PaidBurstingMaxBandwidthMibps <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzRmStorageShare
      -InputObject <PSShare>
      [-QuotaGiB <Int32>]
      [-Metadata <Hashtable>]
      [-AccessTier <String>]
      [-RootSquash <String>]
      [-ProvisionedBandwidthMibps <Int32>]
      [-ProvisionedIops <Int32>]
      [-PaidBurstingEnabled <Boolean>]
      [-PaidBurstingMaxIops <Int32>]
      [-PaidBurstingMaxBandwidthMibps <Int32>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

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

例

例 1: ストレージ ファイル共有のメタデータを変更し、ストレージ アカウント名と共有名を使用して共有クォータを変更する

$share = Update-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -QuotaGiB 200 -Metadata @{tag0="value0";tag1="value1"}

$share

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

$share.Metadata

Key  Value  
---  ----- 
tag0 value0
tag1 value1

このコマンドは、ストレージ ファイル共有のメタデータと共有クォータをストレージ アカウント名と共有名で変更し、返されたファイル共有オブジェクトで変更結果を表示します。

例 2: ストレージ アカウント オブジェクトと共有名を使用してストレージ ファイル共有のメタデータを変更する

$accountObject = Get-AzStorageAccount -ResourceGroupName "myResourceGroup" -StorageAccountName "myStorageAccount"
$share = Update-AzRmStorageShare -StorageAccount $accountObject -Name "myshare" -Metadata @{tag0="value0";tag1="value1"}

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

例 3: パイプラインを使用してストレージ アカウント内のすべてのストレージ ファイル共有の共有クォータを変更する

Get-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" | Update-AzRmStorageShare -QuotaGiB 5000

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

Name     QuotaGiB EnabledProtocols AccessTier Deleted Version ShareUsageBytes
----     -------- ---------------- ---------- ------- ------- ---------------
share1   5000
share2   5000

このコマンドは、パイプラインを使用するストレージ アカウント内のすべてのストレージ ファイル共有の共有クォータを 5,000 GiB に変更します。

例 4: accesstier をクールとして使用してストレージ ファイル共有を変更する

$share = Update-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -AccessTier Cool

ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

このコマンドは、accesstier をクールとして使用してストレージ ファイル共有を変更します。

例 5: ストレージ アカウント内のファイル共有の rootquash を変更する

$share = Update-AzRmStorageShare -ResourceGroupName "myresourcegroup" -StorageAccountName "mystorageaccount" -Name "myshare" -RootSquash NoRootSquash 

$share

   ResourceGroupName: myresourcegroup, StorageAccountName: mystorageaccount

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

$share.RootSquash
NoRootSquash

このコマンドは、共有 RootSquash プロパティを NoRootSquash に変更します。 RootSquash プロパティは、NFS として EnabledProtocol との共有でのみ使用できます。

例 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

-InputObject

Storage Share オブジェクト

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

-Metadata

メタデータの共有

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

-Name

共有名

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

-PaidBurstingEnabled

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

型:Boolean
配置: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

-ResourceId

ファイル共有リソース ID を入力します。

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

-RootSquash

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

型:String
指定可能な値:NoRootSquash, RootSquash, AllSquash
配置: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

入力

出力