New-AzureStorSimpleDeviceVolume
Erstellt ein Volume in einem angegebenen Volumecontainer.
Hinweis
Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.
Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit 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>] Beschreibung
Das Cmdlet New-AzureStorSimpleDeviceVolume erstellt ein Volume in einem angegebenen Volumecontainer. Dieses Cmdlet ordnet jedes Volume einem oder mehreren Zugriffssteuerungsdatensätzen zu. Verwenden Sie zum Abrufen von AccessControlRecord-Objekten das Cmdlet "Get-AzureStorSimpleAccessControlRecord" . Geben Sie einen Namen, eine Größe und einen AppType für das Volume an. Geben Sie außerdem an, ob das Volume online erstellt werden soll, ob die Standardsicherung aktiviert werden soll und ob die Überwachung aktiviert werden soll.
Beispiele
Beispiel 1: Erstellen eines Volumes
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.Der erste Befehl ruft die Zugriffssteuerungsdatensätze in der StorSimple Manager-Dienstkonfiguration mithilfe des Cmdlets "Get-AzureStorSimpleAccessControlRecord" ab und speichert sie dann in der $AcrList Variablen.
Der zweite Befehl ruft den Volumecontainer "VolumeContainer07" für das Gerät namens "Contoso63-AppVm" mithilfe des Cmdlets "Get-AzureStorSimpleDeviceVolumeContainer " ab. Der Befehl übergibt diesen Container mithilfe des Pipelineoperators an das aktuelle Cmdlet. Mit diesem Cmdlet wird das Volume erstellt. Der Befehl gibt den Namen für das Volume, die Größe und die in $AcrList gespeicherten Zugriffssteuerungsdatensätze an. Dieser Befehl startet den Auftrag und gibt dann ein TaskResponse-Objekt zurück. Verwenden Sie das Cmdlet Get-AzureStorSimpleTask , um den Status des Auftrags anzuzeigen.
Beispiel 2: Erstellen eines Volumes ohne Access ControlAccess-Steuerelement -Recordsaccess-Steuerelement
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.Mit diesem Befehl wird der Volumecontainer "VolumeContainer01" für das Gerät namens "Contoso63-AppVm" mithilfe des Cmdlets "Get-AzureStorSimpleDeviceVolumeContainer " abgerufen. Der Befehl übergibt diesen Container mithilfe des Pipelineoperators an das aktuelle Cmdlet. Mit diesem Cmdlet wird das Volume erstellt. Der Befehl gibt den Namen für das Volume, die Größe und einen leeren Wert für Zugriffssteuerungsdatensätze an. Dieser Befehl gibt den WaitForComplete-Parameter an, sodass er eine TaskStatusInfo zurückgibt, nachdem das Volume erstellt wurde.
Da der Befehl keine Zugriffssteuerungsdatensätze angibt, kann auf dieses Volume nicht zugegriffen werden. Sie können den Zugriff später mithilfe des Cmdlets Set-AzureStorSimpleDeviceVolume hinzufügen.
Parameter
-AccessControlRecords
Gibt eine Liste der Zugriffssteuerungsdatensätze an, die dem Volume zugeordnet werden sollen.
| Typ: | List<T>[AccessControlRecord] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-DeviceName
Gibt den Namen des StorSimple-Geräts an, auf dem das Volume erstellt werden soll.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-EnableDefaultBackup
Gibt an, ob die Standardsicherung für das Volume aktiviert werden soll.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-EnableMonitoring
Gibt an, ob die Überwachung für das Volume aktiviert werden soll.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Online
Gibt an, ob das Volume online erstellt werden soll.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Profile
Gibt ein Azure-Profil an.
| Typ: | AzureSMProfile |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-VolumeAppType
Gibt an, ob ein primäres oder Archivvolume erstellt werden soll. Gültige Werte sind: PrimaryVolume und ArchiveVolume.
| Typ: | AppType |
| Aliase: | AppType |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-VolumeContainer
Gibt den Container als DataContainer-Objekt an, in dem das Volume erstellt werden soll. Verwenden Sie zum Abrufen eines VirtualDisk-Objekts das Cmdlet Get-AzureStorSimpleDeviceVolumeContainer .
| Typ: | DataContainer |
| Aliase: | Container |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-VolumeName
Gibt einen Namen für das neue Volume an.
| Typ: | String |
| Aliase: | Name |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-VolumeSizeInBytes
Gibt die Volumengröße in Byte an.
| Typ: | Int64 |
| Aliase: | SizeInBytes |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WaitForComplete
Gibt an, dass dieses Cmdlet auf den Abschluss des Vorgangs wartet, bevor es die Steuerung an die Windows PowerShell-Konsole zurückgibt.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
DataContainer, List\<AccessControlRecord\>
Dieses Cmdlet akzeptiert ein DataContainer-Objekt und eine Liste der AccessControlRecord-Objekte für das neue Volume.
Ausgaben
TaskStatusInfo
Dieses Cmdlet gibt ein TaskStatusInfo-Objekt zurück, wenn Sie den WaitForComplete-Parameter angeben.