你当前正在访问 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 对象。