New-AzNetAppFilesVolume

リファレンス

モジュール:: Az.NetAppFiles

新しい Azure NetApp Files (ANF) ボリュームを作成します。

構文

New-AzNetAppFilesVolume
   -ResourceGroupName <String>
   -Location <String>
   -AccountName <String>
   -PoolName <String>
   -Name <String>
   -UsageThreshold <Int64>
   -SubnetId <String>
   -CreationToken <String>
   [-VolumeType <String>]
   -ServiceLevel <String>
   [-SnapshotId <String>]
   [-ExportPolicy <PSNetAppFilesVolumeExportPolicy>]
   [-ReplicationObject <PSNetAppFilesReplicationObject>]
   [-Snapshot <PSNetAppFilesVolumeSnapshot>]
   [-SnapshotPolicyId <String>]
   [-Backup <PSNetAppFilesVolumeBackupProperties>]
   [-ProtocolType <String[]>]
   [-SnapshotDirectoryVisible]
   [-BackupId <String>]
   [-SecurityStyle <String>]
   [-ThroughputMibps <Double>]
   [-KerberosEnabled]
   [-SmbEncryption]
   [-SmbContinuouslyAvailable]
   [-LdapEnabled]
   [-CoolAccess]
   [-CoolnessPeriod <Int32>]
   [-CoolAccessRetrievalPolicy <String>]
   [-UnixPermission <String>]
   [-AvsDataStore <String>]
   [-IsDefaultQuotaEnabled]
   [-DefaultUserQuotaInKiB <Int64>]
   [-DefaultGroupQuotaInKiB <Int64>]
   [-NetworkFeature <String>]
   [-CapacityPoolResourceId <String>]
   [-ProximityPlacementGroup <String>]
   [-VolumeSpecName <String>]
   [-PlacementRule <System.Collections.Generic.IList`1[Microsoft.Azure.Commands.NetAppFiles.Models.PSKeyValuePairs]>]
   [-EnableSubvolume]
   [-Zone <String[]>]
   [-EncryptionKeySource <String>]
   [-KeyVaultPrivateEndpointResourceId <String>]
   [-DeleteBaseSnapshot]
   [-SmbAccessBasedEnumeration <String>]
   [-SmbNonBrowsable <String>]
   [-IsLargeVolume]
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzNetAppFilesVolume
   -Name <String>
   -UsageThreshold <Int64>
   -SubnetId <String>
   -CreationToken <String>
   -ServiceLevel <String>
   [-ExportPolicy <PSNetAppFilesVolumeExportPolicy>]
   [-ReplicationObject <PSNetAppFilesReplicationObject>]
   [-Snapshot <PSNetAppFilesVolumeSnapshot>]
   [-SnapshotPolicyId <String>]
   [-Backup <PSNetAppFilesVolumeBackupProperties>]
   [-ProtocolType <String[]>]
   [-SnapshotDirectoryVisible]
   [-SecurityStyle <String>]
   [-ThroughputMibps <Double>]
   [-KerberosEnabled]
   [-SmbEncryption]
   [-SmbContinuouslyAvailable]
   [-LdapEnabled]
   [-CoolAccess]
   [-CoolnessPeriod <Int32>]
   [-CoolAccessRetrievalPolicy <String>]
   [-UnixPermission <String>]
   [-AvsDataStore <String>]
   [-IsDefaultQuotaEnabled]
   [-DefaultUserQuotaInKiB <Int64>]
   [-DefaultGroupQuotaInKiB <Int64>]
   [-NetworkFeature <String>]
   [-CapacityPoolResourceId <String>]
   [-ProximityPlacementGroup <String>]
   [-VolumeSpecName <String>]
   [-PlacementRule <System.Collections.Generic.IList`1[Microsoft.Azure.Commands.NetAppFiles.Models.PSKeyValuePairs]>]
   [-EnableSubvolume]
   [-Zone <String[]>]
   [-EncryptionKeySource <String>]
   [-KeyVaultPrivateEndpointResourceId <String>]
   [-DeleteBaseSnapshot]
   [-SmbAccessBasedEnumeration <String>]
   [-SmbNonBrowsable <String>]
   [-IsLargeVolume]
   [-Tag <Hashtable>]
   -PoolObject <PSNetAppFilesPool>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-AzNetAppFilesVolume コマンドレットによって ANF ボリュームが作成されます。

例

例 1: ANF ボリュームを作成する

New-AzNetAppFilesVolume -ResourceGroupName "MyRG" -AccountName "MyAnfAccount" -PoolName "MyAnfPool" -Name "MyAnfVolume" -Location "westus2" -CreationToken "MyAnfVolume" -UsageThreshold 1099511627776 -ServiceLevel "Premium" -SubnetId "/subscriptions/subsId/resourceGroups/MyRG/providers/Microsoft.Network/virtualNetworks/MyVnetName/subnets/MySubNetName"

Location          : westus2
Id                : /subscriptions/subsId/resourceGroups/MyRG/providers/Microsoft.NetApp/netAppAccounts/MyAnfAccount/capacityPools/MyAnfPool/volumes/MyAnfVolume
Name              : MyAnfAccount/MyAnfPool/MyAnfVolume
Type              : Microsoft.NetApp/netAppAccounts/capacityPools/volumes
Tags              :
FileSystemId      : 3e2773a7-2a72-d003-0637-1a8b1fa3eaaf
CreationToken     : MyAnfVolume
ServiceLevel      : Premium
UsageThreshold    : 1099511627776
ProvisioningState : Succeeded
SubnetId          : /subscriptions/f557b96d-2308-4a18-aae1-b8f7e7e70cc7/resourceGroups/MyRG/providers/Microsoft.Network/virtualNetworks/MyVnetName/subnets/default

このコマンドは、プール "MyAnfPool" 内に新しい ANF ボリューム "MyAnfVolume" を作成します。

パラメーター

-AccountName

ANF アカウントの名前

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

-AvsDataStore

ボリュームが Azure VMware Solution (AVS) データストアの目的 (有効、無効) に対して有効になっているかどうかを指定します。

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

-Backup

バックアップオブジェクトを表すハッシュテーブル配列

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

-BackupId

バックアップ ID。バックアップの識別に使用される UUID v4 またはリソース識別子

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

-CapacityPoolResourceId

ボリュームグループを使用してボリュームを作成する場合に使用されるプールリソース ID。

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

-Confirm

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

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

-CoolAccess

ボリュームに対してクールアクセス (階層化) を有効にするかどうかを指定します (既定値は false)。

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

-CoolAccessRetrievalPolicy

CoolAccessRetrievalPolicy は、クールアクセスが有効なボリュームの読み取りパターンに基づいて、クール層から Standard Storage へのデータ取得動作を決定します。このフィールドで使用できる値は次のとおりです。既定値 - データは、ランダム読み取り時にクール層から Standard ストレージにプルされます。このポリシーが既定です。 OnRead - すべてのクライアント駆動型データ読み取りは、順次読み取りとランダム読み取りの両方でクール層から Standard ストレージにプルされます。なし - クライアント駆動型データはクール層から Standard Storage にプルされません。

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

-CoolnessPeriod

クライアントがアクセスしないデータを階層化するまでの日数を指定します (最小 7、最大 63)。

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

-CreationToken

ボリュームの一意のファイルパス

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

-DefaultGroupQuotaInKiB

KiB のボリュームの既定のグループクォータ。 isDefaultQuotaEnabled が設定されている場合、最小値の 4 KiB が適用されます。

型:	Nullable<T>[Int64]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DefaultProfile

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

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

-DefaultUserQuotaInKiB

KiB のボリュームの既定のユーザークォータ。 isDefaultQuotaEnabled が設定されている場合、最小値の 4 KiB が適用されます。

型:	Nullable<T>[Int64]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DeleteBaseSnapshot

有効 (true) の場合、ボリュームの作成操作が完了すると、ボリュームの作成元のスナップショットが自動的に削除されます。既定値は false

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

-EnableSubvolume

ボリュームでサブボリューム操作が有効になっているかどうかを示すフラグ (有効、無効)

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

-EncryptionKeySource

ボリューム内のデータを暗号化するために使用されるキーのソース。 NetApp アカウントに encryption.keySource = 'Microsoft.KeyVault' がある場合に適用されます。使用可能な値: 'Microsoft.NetApp, Microsoft.KeyVault'

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

-ExportPolicy

エクスポートポリシーを表すハッシュテーブル配列

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

-IsDefaultQuotaEnabled

ボリュームに対して既定のクォータが有効になっているかどうかを指定します

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

-IsLargeVolume

ボリュームが大ボリュームか通常ボリュームかを指定します。既定値は false

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

-KerberosEnabled

ボリュームが Kerberos 対応かどうかを説明する

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

-KeyVaultPrivateEndpointResourceId

KeyVault のプライベートエンドポイントのリソース ID。ボリュームと同じ VNET 内に存在する必要があります。 encryptionKeySource = 'Microsoft.KeyVault' の場合にのみ適用されます

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

-LdapEnabled

特定の NFS ボリュームに対して LDAP を有効にするかどうかを指定します。

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

-Location

リソースの場所

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

-Name

ANF ボリュームの名前

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

-NetworkFeature

ボリュームで使用できる Basic ネットワークまたは Standard 機能 (Basic、Standard)。

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

-PlacementRule

特定のボリュームのアプリケーション固有の配置規則。

型:	IList<T>[PSKeyValuePairs]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PoolName

ANF プールの名前

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

-PoolObject

新しいボリュームオブジェクトのプール

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

-ProtocolType

エクスポートポリシーを表すハッシュテーブル配列

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

-ProximityPlacementGroup

ボリュームに関連付けられている近接通信配置グループ。

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

-ReplicationObject

レプリケーションオブジェクトを表すハッシュテーブル配列

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

-ResourceGroupName

ANF アカウントのリソースグループ

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

-SecurityStyle

ボリュームのセキュリティスタイル。使用可能な値は、'ntfs'、'unix' です。

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

-ServiceLevel

ANF ボリュームのサービスレベル

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

-SmbAccessBasedEnumeration

SMB 共有のアクセスベースの列挙共有プロパティを有効にします。 SMB/DualProtocol ボリュームにのみ適用されます

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

-SmbContinuouslyAvailable

SMB ボリュームに対して継続的に使用可能な共有プロパティを有効にします。 SMB ボリュームにのみ適用されます。

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

-SmbEncryption

転送中の smb3 データの暗号化を有効にします。 SMB/DualProtocol ボリュームにのみ適用されます。

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

-SmbNonBrowsable

SMB 共有に対して、参照できないプロパティを有効にします。 SMB/DualProtocol ボリュームにのみ適用されます

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

-Snapshot

スナップショットオブジェクトを表すハッシュテーブル配列

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

-SnapshotDirectoryVisible

有効 (true) の場合、ボリュームには、各ボリュームのスナップショットへのアクセスを提供する読み取り専用の .snapshot ディレクトリが含まれます (既定値は true)

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

-SnapshotId

スナップショットからボリュームを作成します。 UUID v4 またはスナップショットの識別に使用されるリソース識別子

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

-SnapshotPolicyId

ボリュームにスナップショットポリシーを適用するために使用されるスナップショットポリシー ResourceId

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

-SubnetId

委任されたサブネットの Azure リソース URI

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

-Tag

リソースタグを表すハッシュテーブル

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

-ThroughputMibps

このボリュームで達成できる Mibps の最大スループット

型:	Nullable<T>[Double]
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UnixPermission

8 進数の 4 桁の形式で受け入れられる NFS ボリュームに対する UNIX アクセス許可。最初の桁は、設定されたユーザー ID (4)、グループ ID (2) およびスティッキー (1) 属性を選択します。 2 桁目は、ファイルの所有者のアクセス許可を選択します。読み取り (4)、書き込み (2)、実行 (1) です。 3 番目は、同じグループ内の他のユーザーのアクセス許可を選択します。グループに含まれていない他のユーザーの場合は 4 番目です。 0755 - 所有者に読み取り/書き込み/実行アクセス許可を付与し、グループやその他のユーザーに対して読み取り/実行を行います。

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

-UsageThreshold

ファイルシステムで許容される最大ストレージクォータ (バイト単位)

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

-VolumeSpecName

ボリュームスペック名は、データやログなどのボリュームグループ内の特定のボリュームに対するアプリケーション固有の指定または識別子です。

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

-VolumeType

ANF ボリュームの種類

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。このコマンドレットは実行されません。

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

-Zone

可用性ゾーンの一覧

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

入力

PSNetAppFilesPool

出力

PSNetAppFilesVolume

次の方法で共有