你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

New-AzNetAppFilesVolume

模块:

Az.NetAppFiles

创建新的 Azure NetApp 文档 （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 cmdlet 创建 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 帐户的名称

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

-AvsDataStore

指定是否为Azure VMware 解决方案（AVS）数据存储目的启用卷（已启用、禁用）

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

-Backup

表示备份对象的哈希表数组

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

-BackupId

备份 ID。 用于标识备份的 UUID v4 或资源标识符

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

-CapacityPoolResourceId

通过卷组创建卷时使用的池资源 ID。

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-CoolAccess

指定是否为卷启用了冷访问（分层）。

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

-CoolAccessRetrievalPolicy

CoolAccessRetrievalPolicy 根据已启用冷访问卷的读取模式确定从冷层到标准存储的数据检索行为。 此字段的可能值为：默认值 - 数据将从冷层提取到随机读取时的标准存储。 此策略是默认值。 OnRead - 所有客户端驱动的数据读取都从冷层提取到顺序读取和随机读取的标准存储。 从不 - 没有从冷层提取到标准存储的客户端驱动数据。

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

-CoolnessPeriod

指定客户端不访问的数据将分层的天数（最小 7 天，最大 63 天）。

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CreationToken

卷的唯一文件路径

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

-DefaultGroupQuotaInKiB

卷的默认组配额（以 KIB 为单位）。 如果设置了 isDefaultQuotaEnabled，则应用最小值 4 KiBs。

Type:	Nullable<T>[Int64]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultUserQuotaInKiB

卷的默认用户配额（以 KIB 为单位）。 如果设置了 isDefaultQuotaEnabled，则应用最小值 4 KiBs。

Type:	Nullable<T>[Int64]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeleteBaseSnapshot

如果启用（true），则创建卷快照将在卷创建操作完成后自动删除。 默认值为 false

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

-EnableSubvolume

指示是否对卷启用子卷操作（已启用、禁用）的标志

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

-EncryptionKeySource

用于加密卷中数据的密钥源。 如果 NetApp 帐户具有 encryption.keySource = 'Microsoft.KeyVault'，则适用。 可能的值包括：“Microsoft.NetApp、Microsoft.KeyVault”

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

-ExportPolicy

表示导出策略的哈希表数组

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

-IsDefaultQuotaEnabled

指定是否为卷启用了默认配额

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

-IsLargeVolume

指定卷是大型卷还是常规卷。 默认值为 false

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

-KerberosEnabled

描述卷是否已启用 Kerberos

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

-KeyVaultPrivateEndpointResourceId

KeyVault 的专用终结点的资源 ID。 它必须与卷位于同一 VNET 中。 仅当 encryptionKeySource = 'Microsoft.KeyVault' 时才适用

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

-LdapEnabled

指定是否为给定 NFS 卷启用 LDAP。

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

-Location

资源的位置

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

-Name

ANF 卷的名称

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

-NetworkFeature

卷可用的基本网络或标准功能（基本、标准）。

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

-PlacementRule

特定卷的应用程序特定放置规则。

Type:	IList<T>[PSKeyValuePairs]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PoolName

ANF 池的名称

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

-PoolObject

新卷对象的池

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

-ProtocolType

表示导出策略的哈希表数组

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

-ProximityPlacementGroup

与卷关联的邻近放置组。

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

-ReplicationObject

表示副本 (replica)对象的哈希表数组

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

-ResourceGroupName

ANF 帐户的资源组

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

-SecurityStyle

卷的安全样式。 可能的值包括：“ntfs”、“unix”

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

-ServiceLevel

ANF 卷的服务级别

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

-SmbAccessBasedEnumeration

为 SMB 共享启用基于访问的枚举共享属性。 仅适用于 SMB/DualProtocol 卷

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

-SmbContinuouslyAvailable

为 SMB 卷启用连续可用的共享属性。 仅适用于 SMB 卷。

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

-SmbEncryption

为正在进行的 smb3 数据启用加密。 仅适用于 SMB/DualProtocol 卷。

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

-SmbNonBrowsable

为 SMB 共享启用不可浏览的属性。 仅适用于 SMB/DualProtocol 卷

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

-Snapshot

表示快照对象的哈希表数组

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

-SnapshotDirectoryVisible

如果启用（true），卷将包含只读。快照目录，该目录提供对每个卷快照的访问权限（默认为 true）

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

-SnapshotId

从快照创建卷。 用于标识快照的 UUID v4 或资源标识符

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

-SnapshotPolicyId

用于将快照策略应用于卷的快照策略 ResourceId

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

-SubnetId

委托子网的 Azure 资源 URI

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

-Tag

表示资源标记的哈希表

Type:	Hashtable
Aliases:	Tags
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ThroughputMibps

Mibps 中可通过此卷实现的最大吞吐量

Type:	Nullable<T>[Double]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UnixPermission

以八进制 4 位格式接受的 NFS 卷的 UNIX 权限。 第一位数字选择设置用户 ID（4）、设置组 ID （2） 和粘滞 （1） 属性。 第二位数字选择文件所有者的权限：读取（4）、写入（2）和执行（1）。 第三个选择同一组中其他用户的权限。 第四个用户不在组中。 0755 - 向所有者提供读/写/执行权限，并向组和其他用户授予读取/执行权限。

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

-UsageThreshold

文件系统允许的最大存储配额（以字节为单位）

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

-VolumeSpecName

卷规格名称是卷组中特定卷的应用程序特定指定或标识符，例如数据、日志。

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

-VolumeType

ANF 卷的类型

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

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

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

-Zone

可用性区域列表

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

输入

PSNetAppFilesPool

输出

PSNetAppFilesVolume

相关链接

• Get-AzNetAppFilesVolume
• Update-AzNetAppFilesVolume
• Remove-AzNetAppFilesVolume
• Restore-AzNetAppFilesVolume
• Set-AzNetAppFilesVolumePool
• Get-AzNetAppFilesVolumeBackupStatus
• Get-AzNetAppFilesVolumeRestoreStatus
• New-AzNetAppFilesVolumeRestoreStatus
• Approve-AzNetAppFilesReplication
• Inititialize-AzNetAppFilesReplication
• Resume-AzNetAppFilesReplication
• Remove-AzNetAppFilesReplication