共用方式為

New-AzureStorSimpleDeviceVolume

  • 參考
模組:
Azure

在指定的磁片區容器中建立磁片區。

注意

本檔中參考的 Cmdlet 用於管理使用服務管理 API 的舊版 Azure 資源。 如需管理 Azure Resource Manager 資源的 Cmdlet，請參閱 Az PowerShell 模組 。

Syntax

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>]

Description

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 控制記錄access 控制項

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

指定要與磁片區建立關聯的存取控制記錄清單。

Type:List<T>[AccessControlRecord]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DeviceName

指定要在其中建立磁片區的 StorSimple 裝置名稱。

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

-EnableDefaultBackup

指定是否要啟用磁片區的預設備份。

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

-EnableMonitoring

指定是否要啟用磁片區的監視。

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

-Online

指定是否要在線上建立磁片區。

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

-Profile

指定 Azure 設定檔。

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

-VolumeAppType

指定建立主要磁片區或封存磁片區。 有效值為：PrimaryVolume 和 ArchiveVolume。

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

-VolumeContainer

指定要在其中建立磁片區的容器做為 DataContainer 物件。 若要取得 VirtualDisk 物件，請使用 Get-AzureStorSimpleDeviceVolumeContainer Cmdlet。

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

-VolumeName

指定新磁片區的名稱。

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

-VolumeSizeInBytes

指定以位元組為單位的磁片區大小。

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

-WaitForComplete

表示此 Cmdlet 會先等候作業完成，再將控制權傳回 Windows PowerShell 主控台。

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

輸入

DataContainer, List\<AccessControlRecord\>

此 Cmdlet 會接受 DataContainer 物件，以及新磁片區的 AccessControlRecord 物件清單 。

輸出

TaskStatusInfo

如果您指定 WaitForComplete 參數，此 Cmdlet 會 傳回 TaskStatusInfo 物件。