你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
New-AzNetAppFilesVolume
创建新的 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 帐户的名称
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-AvsDataStore
指定是否为 Azure VMware 解决方案（AVS）数据存储目的（已启用、禁用）启用卷
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Backup
表示备份对象的哈希表数组
| 类型: | PSNetAppFilesVolumeBackupProperties |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-BackupId
备份 ID。 用于标识备份的 UUID v4 或资源标识符
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-CapacityPoolResourceId
通过卷组创建卷时使用的池资源 ID。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Confirm
在运行 cmdlet 之前，提示你进行确认。
| 类型: | SwitchParameter |
| 别名: | cf |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-CoolAccess
指定是否为卷启用了冷访问（分层）。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-CoolAccessRetrievalPolicy
CoolAccessRetrievalPolicy 根据已启用冷访问卷的读取模式确定从冷层到标准存储的数据检索行为。 此字段的可能值为：默认值 - 数据将从冷层提取到随机读取时的标准存储。 此策略是默认值。 OnRead - 所有客户端驱动的数据读取都从冷层提取到顺序读取和随机读取的标准存储。 从不 - 没有从冷层提取到标准存储的客户端驱动数据。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-CoolnessPeriod
指定客户端不访问的数据将分层的天数（最小 7 天，最大 63 天）。
| 类型: | Nullable<T>[Int32] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-CreationToken
卷的唯一文件路径
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-DefaultGroupQuotaInKiB
卷的默认组配额（以 KIB 为单位）。 如果设置了 isDefaultQuotaEnabled，则应用最小值 4 KiBs。
| 类型: | Nullable<T>[Int64] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
| 类型: | IAzureContextContainer |
| 别名: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DefaultUserQuotaInKiB
卷的默认用户配额（以 KIB 为单位）。 如果设置了 isDefaultQuotaEnabled，则应用最小值 4 KiBs。
| 类型: | Nullable<T>[Int64] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-DeleteBaseSnapshot
如果启用（true），则卷创建的快照将在卷创建作完成后自动删除。 默认值为 false
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EnableSubvolume
指示是否对卷启用子卷作（已启用、禁用）的标志
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-EncryptionKeySource
用于加密卷中数据的密钥源。 如果 NetApp 帐户具有 encryption.keySource = “Microsoft.KeyVault”，则适用。 可能的值为：“Microsoft.NetApp，Microsoft.KeyVault”
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ExportPolicy
表示导出策略的哈希表数组
| 类型: | PSNetAppFilesVolumeExportPolicy |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-IsDefaultQuotaEnabled
指定是否为卷启用了默认配额
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-IsLargeVolume
指定卷是大型卷还是常规卷。 默认值为 false
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-KerberosEnabled
描述卷是否已启用 Kerberos
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-KeyVaultPrivateEndpointResourceId
KeyVault 的专用终结点的资源 ID。 它必须与卷位于同一 VNET 中。 仅当 encryptionKeySource = “Microsoft.KeyVault” 时才适用
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-LdapEnabled
指定是否为给定 NFS 卷启用 LDAP。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Location
资源的位置
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Name
ANF 卷的名称
| 类型: | String |
| 别名: | VolumeName |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-NetworkFeature
卷可用的基本网络或标准功能（基本、标准）。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PlacementRule
特定卷的应用程序特定放置规则。
| 类型: | IList<T>[PSKeyValuePairs] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-PoolName
ANF 池的名称
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-PoolObject
新卷对象的池
| 类型: | PSNetAppFilesPool |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-ProtocolType
表示导出策略的哈希表数组
| 类型: | String[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ProximityPlacementGroup
与卷关联的邻近放置组。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ReplicationObject
表示复制对象的哈希表数组
| 类型: | PSNetAppFilesReplicationObject |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ResourceGroupName
ANF 帐户的资源组
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-SecurityStyle
卷的安全样式。 可能的值包括：“ntfs”、“unix”
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ServiceLevel
ANF 卷的服务级别
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-SmbAccessBasedEnumeration
为 SMB 共享启用基于访问的枚举共享属性。 仅适用于 SMB/DualProtocol 卷
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SmbContinuouslyAvailable
为 SMB 卷启用连续可用的共享属性。 仅适用于 SMB 卷。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SmbEncryption
为正在进行的 smb3 数据启用加密。 仅适用于 SMB/DualProtocol 卷。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SmbNonBrowsable
为 SMB 共享启用不可浏览的属性。 仅适用于 SMB/DualProtocol 卷
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Snapshot
表示快照对象的哈希表数组
| 类型: | PSNetAppFilesVolumeSnapshot |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SnapshotDirectoryVisible
如果启用（true），卷将包含只读的 .snapshot 目录，该目录提供对每个卷快照的访问权限（默认值为 true）
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SnapshotId
从快照创建卷。 用于标识快照的 UUID v4 或资源标识符
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SnapshotPolicyId
用于将快照策略应用到卷的快照策略 ResourceId
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-SubnetId
委托子网的 Azure 资源 URI
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Tag
表示资源标记的哈希表
| 类型: | Hashtable |
| 别名: | Tags |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ThroughputMibps
Mibps 中可通过此卷实现的最大吞吐量
| 类型: | Nullable<T>[Double] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-UnixPermission
以八进制 4 位格式接受的 NFS 卷的 UNIX 权限。 第一位数字选择设置用户 ID（4）、设置组 ID （2） 和粘滞 （1） 属性。 第二位数字选择文件所有者的权限：读取（4）、写入（2）和执行（1）。 第三个选择同一组中其他用户的权限。 第四个用户不在组中。 0755 - 向所有者提供读/写/执行权限，并向组和其他用户授予读取/执行权限。
| 类型: | String |
| 别名: | UnixPermissions |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-UsageThreshold
文件系统允许的最大存储配额（以字节为单位）
| 类型: | Int64 |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-VolumeSpecName
卷规格名称是卷组中特定卷的应用程序特定指定或标识符，例如数据、日志。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-VolumeType
ANF 卷的类型
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。
| 类型: | SwitchParameter |
| 别名: | wi |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Zone
可用性区域列表
| 类型: | String[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
输出
相关链接
- Get-AzNetAppFilesVolume
- Update-AzNetAppFilesVolume
- Remove-AzNetAppFilesVolume
- Restore-AzNetAppFilesVolume
- Set-AzNetAppFilesVolumePool
- Get-AzNetAppFilesVolumeBackupStatus
- Get-AzNetAppFilesVolumeRestoreStatus
- New-AzNetAppFilesVolumeRestoreStatus
- Approve-AzNetAppFilesReplication
- Inititialize-AzNetAppFilesReplication
- Resume-AzNetAppFilesReplication
- Remove-AzNetAppFilesReplication
