Skip to content

New-vRAVirtualDisk

SYNOPSIS

Retrieve a vRA Machine's Disks

SYNTAX

ByName (Default)

New-vRAVirtualDisk -Name <String> -CapacityInGB <Int32> -ProjectName <String[]> [-DeviceDescription <String[]>]
 [-Persistent] [-Encrypted] [-WaitForCompletion] [-CompletionTimeout <Int32>] [-Force] [-WhatIf] [-Confirm]
 [<CommonParameters>]

ById

New-vRAVirtualDisk -Name <String> -CapacityInGB <Int32> -ProjectId <String[]> [-DeviceDescription <String[]>]
 [-Persistent] [-Encrypted] [-WaitForCompletion] [-CompletionTimeout <Int32>] [-Force] [-WhatIf] [-Confirm]
 [<CommonParameters>]

DESCRIPTION

Retrieve the disks for a vRA Machine

EXAMPLES

EXAMPLE 1

New-vRAVirtualDisk -Name 'test_disk_1' -CapacityInGB 10 -ProjectId 'b1dd48e71d74267559bb930934470'

EXAMPLE 2

New-vRAVirtualDisk -Name 'test_disk_1' -CapacityInGB 10 -ProjectName 'GOLD'

EXAMPLE 3

New-vRAVirtualDisk -Name 'test_disk_1' -CapacityInGB 10 -ProjectName 'GOLD' -WaitForCompletion

EXAMPLE 4

New-vRAVirtualDisk -Name 'test_disk_1' -CapacityInGB 10 -ProjectName 'GOLD' -WaitForCompletion -CompletionTimeout 300

EXAMPLE 5

New-vRAVirtualDisk -Name 'test_disk_1' -CapacityInGB 10 -ProjectId 'b1dd48e71d74267559bb930934470' -Persistent -Encrypted

PARAMETERS

-Name

The Name you would like to give the new disk/volume

Type: String
Parameter Sets: (All)
Aliases:

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

-CapacityInGB

Integer value indicating capacity of the disk in GB

Type: Int32
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False

-ProjectId

The id of the project in which to build the disk/volume in

Type: String[]
Parameter Sets: ById
Aliases:

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

-ProjectName

As an alternate, a project name can be given for this operation

Type: String[]
Parameter Sets: ByName
Aliases:

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

-DeviceDescription

A description we can associate with the disk after creating it

Type: String[]
Parameter Sets: (All)
Aliases:

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

-Persistent

Another switch indicating the disk to be a persistent disk

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Encrypted

Switch indicating if the device will be encrypted during build

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-WaitForCompletion

If this flag is added, this function will wait for the request to complete and will reutnr the created Virtual Disk

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-CompletionTimeout

The default of this paramter is 2 minutes (120 seconds), but this parameter can be overriden here

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: 120
Accept pipeline input: False
Accept wildcard characters: False

-Force

Force the creation

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

System.Management.Automation.PSObject.

NOTES