NAME

New-HPOVProfileAttachVolume

SYNOPSIS

Create volume attachment object for a server profile.

SYNTAX

New-HPOVProfileAttachVolume -VolumeID <Int32> -Volume <Object> [-LunIdType <String>] [[-LunID] <Int32>] [-ProfileConnectionID <Int32>] [<CommonParameters>]

New-HPOVProfileAttachVolume -VolumeID <Int32> -Volume <Object> -LunIdType <String> -LunID <Int32> [-ProfileConnectionID <Int32>] [<CommonParameters>]

DESCRIPTION

A helper CMDLET to assist with attaching Storage Volumes when creating (New-HPOVProfile) a server profile. The returned resource will contain a volume storage PowerShell resource to attach to a Server Profile.

PARAMETERS

-VolumeID [<Int32>]

Alias [-id]

The numeric identifier for this volume. Does not pertain to exported LUN ID value on array.

Aliases -id
Required? false
Position? 1
Default value 1
Accept pipeline input? false
Accept wildcard characters?    false
-Volume [<Object>]
The Volume Name, URI or Object to attach.
Aliases None
Required? false
Position? 2
Default value <none>
Accept pipeline input? false
Accept wildcard characters?    false
-LunIdType [<String>]

Alias [-type]

Optional. Specify Auto or Manual for the LUN ID assignment type. If Manual, use the -LunID parameter and provide a numerical value.

Aliases -type
Required? false
Position? 3
Default value Auto
Accept pipeline input? false
Accept wildcard characters?    false
-LunID [<Int32>]
The Host LUN ID numerical value that will be configured in the Volume export on the Storage System. Accepted range: 0-254
Aliases None
Required? false
Position? 4
Default value 0
Accept pipeline input? false
Accept wildcard characters?    false
-ProfileConnectionID [<Int32>]
Optional. The Server Profile Connection ID. If value is not provided, the New-HPOVProfile will attempt to detect the FC connection that will map to the Volume.
Aliases None
Required? false
Position? 5
Default value 0
Accept pipeline input? false
Accept wildcard characters?    false

<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

System.String

Storage Volume Name or URI

System.ObjectSystem.Management.Automation.PSCustomObject

Storage Volume Resource object

OUTPUTS

System.ObjectSystem.Management.Automation.PSCustomObject

Returns a storage volume attachment object which may be used during profile creation. Returned resource:
    Example 1. Auto Host LUN ID
    id                     : 0
    lunType                : Auto
    volumeUri              : /rest/storage-volumes/{guid}
    volumeStoragePoolUri   : /rest/storage-pools/{guid}
    volumeStorageSystemUri : /rest/storage-systems/{guid}
    storagePaths           : {}

    Example 2. Manual Host LUN ID
    id                     : 0
    lunType                : Manual
    volumeUri              : /rest/storage-volumes/{guid}
    volumeStoragePoolUri   : /rest/storage-pools/{guid}
    volumeStorageSystemUri : /rest/storage-systems/{guid}
    storagePaths           : {}
    lun                    : 10

RELATED LINKS

EXAMPLES

-------------------------- EXAMPLE 1 -------------------------- 

PS C:\> $attachVolume = New-HPOVProfileAttachVolume -volumeid 1 -volume Volume1

Create a Volume Attach object that maps to the 'Volume1' storage volume with an Auto assigned Host LUN ID.
-------------------------- EXAMPLE 2 -------------------------- 

PS C:\> $attachVolume = Get-HPOVStorageVolume Volume1 | New-HPOVProfileAttachVolume -volumeid 1
 
Get the 'Volume1' Storage Volume via the Get-HPOVStorageVolume cmdlet, and pipe the resource object to the Get-HPOVProfileAttachVolume cmdlet.
-------------------------- EXAMPLE 3 -------------------------- 

PS C:\> $attachVolume = Get-HPOVStorageVolume Volume1 | New-HPOVProfileAttachVolume -volumeid 1 -lunidtype manual -lunid 1
   
Get the 'Volume1' Storage Volume via the Get-HPOVStorageVolume cmdlet, and pipe the resource object to the Get-HPOVProfileAttachVolume cmdlet, providing a manual Host LUN ID.
-------------------------- EXAMPLE 4 -------------------------- 

PS C:\> $attachVolume = Get-HPOVStorageVolume Volume1 | New-HPOVProfileAttachVolume -volumeid 1 -lunidtype manual -lunid 1 -evenpathdisabled
    
Get the 'Volume1' Storage Volume via the Get-HPOVStorageVolume cmdlet, and pipe the resource object to the Get-HPOVProfileAttachVolume cmdlet, providing a manual Host LUN ID and disabling FC Even Path.
-------------------------- EXAMPLE 5 -------------------------- 

PS C:\> $volume1 = Get-HPOVStorageVolume Volume1 | New-HPOVProfileAttachVolume -volumeid 1
PS C:\> $volume2 = Get-HPOVStorageVolume SharedVolume1 | New-HPOVProfileAttachVolume -volumeid 2
PS C:\> $attachVolumes = @($volume1,$volume2)
  
Get the 'Volume1' and 'SharedVolume1' Storage Volumes via the Get-HPOVStorageVolume cmdlet, and pipe the resource objects to the Get-HPOVProfileAttachVolume cmdlet, saving to $attachVolumes array.

Last edited Aug 21, 2014 at 4:12 PM by chrislynchhp, version 3