Initialize-iBMCVolume

NAME Initialize-iBMCVolume



SYNOPSIS

Modify properties of the specified volume of a server.





SYNTAX

Initialize-iBMCVolume [-Session] <RedfishSession[]> [-StorageId] <String[]> [-VolumeId] <String[]> [-InitAction]

{QuickInit | FullInit | CancelInit} [<CommonParameters>]





DESCRIPTION

Modify properties of the specified volume of a server.

This cmdlet works only after BIOS boot is complete when the RAID controller card supports out-of-band management

or after iBMA 2.0 has been installed and started.





PARAMETERS

-Session <RedfishSession[]>

iBMC redfish session object which is created by Connect-iBMC cmdlet.

A session object identifies an iBMC server to which this cmdlet will be executed.



Required? true

Position? 1

Default value

Accept pipeline input? true (ByValue, ByPropertyName)

Accept wildcard characters? false



-StorageId <String[]>

Indicates the identifier of the storage which the volume belongs to.

The Id properties of "Get-iBMCRAIDControllers" cmdlet's return value represents Storage ID.



Required? true

Position? 2

Default value

Accept pipeline input? true (ByValue, ByPropertyName)

Accept wildcard characters? false



-VolumeId <String[]>

Indicates the identifier of the Volume to initialize.

The Id properties of "Get-iBMCVolume" cmdlet's return value represents Volume ID.



Required? true

Position? 2

Default value

Accept pipeline input? true (ByValue, ByPropertyName)

Accept wildcard characters? false



-InitAction

Indicates the initialization action of volume.

Available Value Set: QuickInit, FullInit, CancelInit.

- QuickInit: perform quick initialization. No task will be created.

- FullInit: perform complete initialization. A task will be created.

- CancelInit: cancel the initialization. No task will be created.



Required? true

Position? 3

Default value

Accept pipeline input? true (ByValue, ByPropertyName)

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 (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS

PSObject[]

Returns null when InitAction is "QuickInit" or "CancelInit"

while returns a async Task when InitAction is "FullInit" if cmdlet executes successfully.

In case of an error or warning, exception will be returned.





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



PS C:\\>$credential = Get-Credential



PS C:\\> $Session = Connect-iBMC -Address 10.1.1.2 -Credential $credential -TrustCert

PS C:\\> Initialize-iBMCVolume -Session $session -StorageId RAIDStorage0 `

-VolumeId LogicalDrive0 -InitAction QuickInit











RELATED LINKS

https://github.com/Huawei/Huawei-iBMC-Cmdlets



Get-iBMCVolume

Connect-iBMC

Disconnect-iBMC