New-SCStorageLogicalUnit
Creates a logical unit from unallocated capacity in a storage pool.
Syntax
New-SCStorageLogicalUnit
[-LogicalUnitCopyMethod <StorageLogicalUnitCopyMethod>]
[-VMHostGroup <HostGroup>]
[-VMMServer <ServerConnection>]
[-StorageLogicalUnit] <StorageLogicalUnit>
-Name <String>
[-Description <String>]
-TargetStoragePool <StoragePool>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] New-SCStorageLogicalUnit
[-LogicalUnitCopyMethod <StorageLogicalUnitCopyMethod>]
[-VMHostGroup <HostGroup>]
[-VMMServer <ServerConnection>]
[-StorageLogicalUnit] <StorageLogicalUnit>
-Name <String>
[-Description <String>]
[-SetLogicalUnitCopySource]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] New-SCStorageLogicalUnit
[-ProvisioningType <StorageProvisioningType>]
[-VMHostGroup <HostGroup>]
[-VMMServer <ServerConnection>]
-Name <String>
[-Description <String>]
[-StoragePool] <StoragePool>
-DiskSizeMB <UInt64>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Description
The New-SCStorageLogicalUnit cmdlet creates a logical unit from unallocated capacity in a storage pool.
Examples
Example 1: Create a copy of an existing logical unit
PS C:\> $SourceLU = Get-SCStorageLogicalUnit -Name "LUN01"
PS C:\> New-SCStorageLogicalUnit -SetLogicalUnitCopySource -StorageLogicalUnit $SourceLU -Name "NewLU" -LogicalUnitCopyMethod CloneThe first command gets the storage logical unit object named LUN01 and stores the object in the $SourceLU variable.
The second command creates a new logical unit named NewLU by cloning LUN01.
Parameters
-Description
States a description for the specified object.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DiskSizeMB
Specifies the size of a disk in megabytes (MB).
| Type: | UInt64 |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Specifies that job progress is tracked and stored in the variable named by this parameter.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LogicalUnitCopyMethod
Specifies the method used by the array to copy an existing logical unit. Valid values: Clone, Snapshot.
| Type: | StorageLogicalUnitCopyMethod |
| Accepted values: | Snapshot, Clone, RemoteMirror |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Specifies the name of a VMM object.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Specifies the ID of the Performance and Resource Optimization tip (PRO tip) that triggered this action. This parameter lets you audit PRO tips.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ProvisioningType
Specifies a storage provisioning type. Valid values are: Thin, Fixed.
Thin indicates that capacity is committed on demand for a storage logical unit.
Fixed indicates that capacity is fully committed for a fixed-size storage logical unit.
| Type: | StorageProvisioningType |
| Accepted values: | Unknown, Thin, Fixed |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indicates that the job runs asynchronously so that control returns to the command shell immediately.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SetLogicalUnitCopySource
Indicates that the specified storage logical unit is the source from which a clone is copied.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StorageLogicalUnit
Specifies a storage logical unit object.
| Type: | StorageLogicalUnit |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-StoragePool
Specifies a storage pool object.
| Type: | StoragePool |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-TargetStoragePool
Specifies the target storage pool.
| Type: | StoragePool |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMHostGroup
Specifies a virtual machine host group object.
| Type: | HostGroup |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Specifies a VMM server object.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Outputs
StorageLogicalUnit
This cmdlet returns a StorageLogicalUnit object.