New-AzureStorSimpleDeviceVolume

指定したボリューム コンテナーにボリュームを作成します。

Note

このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用する従来の Azure リソースを管理するためのものです。 ASM の提供終了が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、Azure Service Manager の提供終了に関するページを参照してください

Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (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 コマンドレットは、指定されたボリューム コンテナーにボリュームを作成します。 このコマンドレットは、各ボリュームを 1 つ以上のアクセス制御レコードに関連付けます。 AccessControlRecord オブジェクトを取得するには、Get-AzureStorSimpleAccessControlRecord コマンドレットを使用します。 ボリュームの名前、サイズ、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 コマンドレットを使用して StorSimple Manager サービス構成のアクセス制御レコードを取得し、$AcrList変数に格納します。

2 番目のコマンドは、Get-AzureStorSimpleDeviceVolumeContainer コマンドレットを使用 して、Contoso63-AppVm という名前のデバイスの VolumeContainer07 という名前のボリューム コンテナーを取得します。 このコマンドは、パイプライン演算子を使用して、そのコンテナーを現在のコマンドレットに渡します。 このコマンドレットは、ボリュームを作成します。 このコマンドは、ボリュームの名前、サイズ、および$AcrListに格納されているアクセス制御レコードを指定します。 このコマンドはジョブを開始し、TaskResponse オブジェクトを返します。 ジョブの状態を表示するには、Get-AzureStorSimpleTask コマンドレットを使用します。

例 2: Access Controlaccess コントロール recordsaccess 制御なしでボリュームを作成する

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 コマンドレットを使用 して、Contoso63-AppVm という名前のデバイスの VolumeContainer01 という名前のボリューム コンテナーを取得します。 このコマンドは、パイプライン演算子を使用して、そのコンテナーを現在のコマンドレットに渡します。 このコマンドレットは、ボリュームを作成します。 このコマンドは、ボリュームの名前、サイズ、およびアクセス制御レコードの空の値を指定します。 このコマンドは WaitForComplete パラメーターを指定するため、ボリュームの作成後に TaskStatusInfo を返します。

このコマンドはアクセス制御レコードを指定しないため、このボリュームにはアクセスできません。 Set-AzureStorSimpleDeviceVolume コマンドレットを使用して、後でアクセスを追加できます。

パラメーター

-AccessControlRecords

ボリュームに関連付けるアクセス制御レコードのリストを指定します。

型:List<T>[AccessControlRecord]
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-DeviceName

ボリュームを作成する StorSimple デバイスの名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EnableDefaultBackup

ボリュームの既定のバックアップを有効にするかどうかを指定します。

型:Boolean
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EnableMonitoring

ボリュームの監視を有効にするかどうかを指定します。

型:Boolean
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Online

ボリュームをオンラインで作成するかどうかを指定します。

型:Boolean
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Profile

Azure プロファイルを指定します。

型:AzureSMProfile
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-VolumeAppType

プライマリ ボリュームとアーカイブ ボリュームのどちらを作成するかを指定します。 有効な値は PrimaryVolume と ArchiveVolume です。

型:AppType
Aliases:AppType
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-VolumeContainer

ボリュームを作成する DataContainer オブジェクトとしてコンテナーを指定します。 VirtualDisk オブジェクトを取得するには、Get-AzureStorSimpleDeviceVolumeContainer コマンドレットを使用します。

型:DataContainer
Aliases:Container
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-VolumeName

新しいボリュームの名前を指定します。

型:String
Aliases:Name
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-VolumeSizeInBytes

ボリューム サイズをバイト単位で指定します。

型:Int64
Aliases:SizeInBytes
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WaitForComplete

このコマンドレットは、Windows PowerShell コンソールに制御を返す前に、操作が完了するまで待機することを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

DataContainer, List\<AccessControlRecord\>

このコマンドレットは、DataContainer オブジェクトと、新しいボリュームの AccessControlRecord オブジェクトの一覧を受け入れます。

出力

TaskStatusInfo

WaitForComplete パラメーターを 指定すると、このコマンドレットは TaskStatusInfo オブジェクトを します。