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

New-AzureStorSimpleDeviceVolume

在指定的卷容器中创建卷。

注意

本文档中引用的 cmdlet 用于管理使用 Azure Service Manager (ASM) API 的旧式 Azure 资源。 创建新资源时,建议不要使用旧的 PowerShell 模块,因为计划将停用 ASM。 有关详细信息,请参阅 Azure Service Manager 停用

Az PowerShell 模块是建议用于管理 PowerShell 的 Azure 资源管理器 (ARM) 资源的 PowerShell 模块。

语法

New-AzureStorSimpleDeviceVolume
   -DeviceName <String>
   -VolumeContainer <DataContainer>
   -VolumeName <String>
   -VolumeSizeInBytes <Int64>
   -AccessControlRecords <System.Collections.Generic.List`1[Microsoft.WindowsAzure.Management.StorSimple.Models.AccessControlRecord]>
   -VolumeAppType <AppType>
   -Online <Boolean>
   -EnableDefaultBackup <Boolean>
   -EnableMonitoring <Boolean>
   [-WaitForComplete]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

说明

New-AzureStorSimpleDeviceVolume cmdlet 在指定的卷容器中创建卷。 此 cmdlet 将每个卷与一个或多个访问控制记录相关联。 若要获取 AccessControlRecord 对象,请使用 Get-AzureStorSimpleAccessControlRecord cmdlet。 指定卷的名称、大小和 AppType。 此外,指定是否联机创建卷、是否启用默认备份以及是否启用监视。

示例

示例 1:创建卷

PS C:\>$AcrList = Get-AzureStorSimpleAccessControlRecord
PS C:\> Get-AzureStorSimpleDeviceVolumeContainer -DeviceName "Contoso63-AppVm" -VolumeContainerName "VolumeContainer07" | New-AzureStorSimpleDeviceVolume -DeviceName "Contoso63-AppVm" -VolumeName "Volume18" -Size 2000000000 -AccessControlRecords $AcrList -VolumeAppType PrimaryVolume -Online $True -EnableDefaultBackup $False -EnableMonitoring $False

VERBOSE: ClientRequestId: a29d1a84-1f81-4f20-9130-7adfe45e41fb_PS
VERBOSE: ClientRequestId: 8fa63df1-3f81-4029-a536-b536a70068ad_PS
VERBOSE: ClientRequestId: 964c5744-8bb1-4f70-beda-95ca4c7f3eb6_PS
VERBOSE: ClientRequestId: f09fff3a-54fa-4a0e-93db-b079260ed2dd_PS
VERBOSE: ClientRequestId: 59aa29e3-8044-411a-adae-b64a2681ffed_PS
VERBOSE: ClientRequestId: 0ffd0297-19be-40fe-a64e-6a2947d831b4_PS
c3b1ad53-7a51-49d7-ae83-94ff1ff3ab90
VERBOSE: The create task is submitted successfully. Please use the command Get-AzureStorSimpleTask -InstanceId
c3b1ad53-7a51-49d7-ae83-94ff1ff3ab90 for tracking the task's status
VERBOSE: Volume container with name: VolumeContainer07 is found.

第一个命令使用 Get-AzureStorSimpleAccessControlRecord cmdlet 获取 StorSimple Manager 服务配置中的访问控制记录,然后将其存储在 $AcrList 变量中。

第二个命令使用 Get-AzureStorSimpleDeviceVolumeContainer cmdlet 获取名为 Contoso63-AppVm 的设备名为 VolumeContainer07 的卷容器。 该命令使用管道运算符将该容器传递到当前 cmdlet。 此 cmdlet 创建卷。 该命令指定存储在$AcrList中的卷、大小和访问控制记录的名称。 此命令启动作业,然后返回 TaskResponse 对象。 若要查看作业的状态,请使用 Get-AzureStorSimpleTask cmdlet。

示例 2:创建不包含 访问控制access 控件 recordaccess 控件的卷

PS C:\>Get-AzureStorSimpleDeviceVolumeContainer -DeviceName "Contoso63-AppVm" -VolumeContainerName "VolumeContainer01" | New-AzureStorSimpleDeviceVolume -DeviceName "Contoso63-AppVm" -VolumeName "Volume22" -Size 2000000000 -AccessControlRecords @() -VolumeAppType PrimaryVolume -Online $True -EnableDefaultBackup $False -EnableMonitoring $False -WaitForComplete
VERBOSE: ClientRequestId: 3f359790-7e1f-48e7-acf8-ecabba850966_PS
VERBOSE: ClientRequestId: 2723ebcf-cd72-47bb-99b5-0c099d45641b_PS
VERBOSE: ClientRequestId: e605091f-dd63-42a7-bda2-24753cbc1f9a_PS
VERBOSE: ClientRequestId: b3fd08c3-67c5-4309-9591-15d92c360469_PS
VERBOSE: ClientRequestId: 15a024a3-b0c9-4f83-9c34-0ed8b95d024b_PS
VERBOSE: ClientRequestId: c13f92f9-aea1-40dd-af80-3affe273adbe_PS


TaskId       : ceef657e-390e-4f7a-aab7-669a29c29e7f
TaskResult   : Succeeded
TaskStatus   : Completed
ErrorCode    : 
ErrorMessage : 
TaskSteps    : {Microsoft.WindowsAzure.Management.StorSimple.Models.TaskStep}

VERBOSE: The task created for your create operation has completed successfully. 
VERBOSE: ClientRequestId: 1d79febf-f752-4255-af2d-230d40773bc6_PS
AccessType             : NoAccess
AcrIdList              : {}
AcrList                : {}
AppType                : PrimaryVolume
DataContainer          : Microsoft.WindowsAzure.Management.StorSimple.Models.DataContainer
DataContainerId        : 68b63d15-6aa5-4e69-9f9d-4a0bc607d6e9
InstanceId             : SS-VOL-d73b7eec-76fc-4310-b347-69b160de8cdd
InternalInstanceId     : 
IsBackupEnabled        : False
IsDefaultBackupEnabled : False
IsMonitoringEnabled    : False
Name                   : Volume22
Online                 : True
OperationInProgress    : None
SizeInBytes            : 2000000000
VSN                    : SS-VOL-d73b7eec-76fc-4310-b347-69b160de8cdd

VERBOSE: Volume container with name: VolumeContainer01 is found.

此命令使用 Get-AzureStorSimpleDeviceVolumeContainer cmdlet 获取名为 Contoso63-AppVm 的设备名为 VolumeContainer01 的卷容器。 该命令使用管道运算符将该容器传递到当前 cmdlet。 此 cmdlet 创建卷。 该命令指定卷的名称、大小和访问控制记录的空值。 此命令指定 WaitForComplete 参数,以便在创建卷后返回 TaskStatusInfo

由于命令未指定访问控制记录,因此无法访问此卷。 稍后可以使用 Set-AzureStorSimpleDeviceVolume cmdlet 添加访问权限

参数

-AccessControlRecords

指定要与卷关联的访问控制记录的列表。

类型:List<T>[AccessControlRecord]
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-DeviceName

指定要在其中创建卷的 StorSimple 设备的名称。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-EnableDefaultBackup

指定是否为卷启用默认备份。

类型:Boolean
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-EnableMonitoring

指定是否为卷启用监视。

类型:Boolean
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Online

指定是否联机创建卷。

类型:Boolean
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Profile

指定 Azure 配置文件。

类型:AzureSMProfile
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VolumeAppType

指定是创建主卷还是存档卷。 有效值为:PrimaryVolume 和 ArchiveVolume。

类型:AppType
别名:AppType
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-VolumeContainer

将容器指定为 要在其中创建卷的 DataContainer 对象。 若要获取 VirtualDisk 对象,请使用 Get-AzureStorSimpleDeviceVolumeContainer cmdlet。

类型:DataContainer
别名:Container
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-VolumeName

指定新卷的名称。

类型:String
别名:Name
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-VolumeSizeInBytes

指定卷大小(以字节为单位)。

类型:Int64
别名:SizeInBytes
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-WaitForComplete

指示此 cmdlet 等待操作完成,然后再将控制权返回到 Windows PowerShell 控制台。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

DataContainer, List\<AccessControlRecord\>

此 cmdlet 接受 DataContainer 对象和新卷的 AccessControlRecord 对象列表

输出

TaskStatusInfo

如果指定 WaitForComplete 参数,此 cmdlet 将返回 TaskStatusInfo 对象。