exports/Mount-CVVirtualMachine.ps1


# ----------------------------------------------------------------------------------
#
# Copyright Microsoft Corporation
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
# http://www.apache.org/licenses/LICENSE-2.0
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
# ----------------------------------------------------------------------------------

<#
.Synopsis
Method to initiate live mount of specified virtual machine.
.Description
Method to initiate live mount of specified virtual machine from specified media.
.Example
PS C:\> {{ Add code here }}
 
{{ Add output here }}
.Example
PS C:\> {{ Add code here }}
 
{{ Add output here }}
 
.Inputs
System.Object
.Outputs
System.Management.Automation.PSObject
.Link
https://docs.microsoft.com/en-us/powershell/module/commvaultpowershell/mount-cvvirtualmachine
#>

function Mount-CVVirtualMachine {
[Alias('Mount-CVVM')]
[OutputType([System.Management.Automation.PSObject])]
[CmdletBinding(DefaultParameterSetName='ByName', PositionalBinding=$false, SupportsShouldProcess, ConfirmImpact='Medium')]
param(
    [Parameter(ParameterSetName='ByName', Mandatory)]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # Source virtual machine Name.
    ${Name},

    [Parameter(ParameterSetName='ByName', Mandatory)]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # Source virtual machine associated ClientName.
    ${ClientName},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # Specify SubclientName to override the default behaviour.
    ${SubclientName},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # Specify NetworkName for live mount operation.
    ${NetworkName},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # Specify PolicyName for live mount operation.
    ${PolicyName},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # Specify JobId to live mount from particular backup job.
    ${JobId},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # Specify LiveMountVMName to override default naming behavior.
    ${LiveMountVMName},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # Specify ExpirationInHours for in-place live mount.
    ${ExpirationInHours},

    [Parameter()]
    [Commvault.Powershell.Category('Body')]
    [System.Management.Automation.SwitchParameter]
    # Switch to Force override of default 'WhatIf' confirmation behavior.
    ${Force},

    [Parameter(ParameterSetName='ById', Mandatory)]
    [Alias('VMName')]
    [Commvault.Powershell.Category('Body')]
    [System.String]
    # Specify Id representing source virtual machine GUID.
    ${Id},

    [Parameter(ParameterSetName='ByObject', Mandatory, ValueFromPipeline, ValueFromPipelineByPropertyName)]
    [Commvault.Powershell.Category('Body')]
    [System.Object]
    ${ClientObject}
)

begin {
    try {
        $outBuffer = $null
        if ($PSBoundParameters.TryGetValue('OutBuffer', [ref]$outBuffer)) {
            $PSBoundParameters['OutBuffer'] = 1
        }
        $parameterSet = $PSCmdlet.ParameterSetName
        $mapping = @{
            ByName = 'CommvaultPowershell.custom\Mount-CVVirtualMachine';
            ById = 'CommvaultPowershell.custom\Mount-CVVirtualMachine';
            ByObject = 'CommvaultPowershell.custom\Mount-CVVirtualMachine';
        }
        $wrappedCmd = $ExecutionContext.InvokeCommand.GetCommand(($mapping[$parameterSet]), [System.Management.Automation.CommandTypes]::Cmdlet)
        $scriptCmd = {& $wrappedCmd @PSBoundParameters}
        $steppablePipeline = $scriptCmd.GetSteppablePipeline($MyInvocation.CommandOrigin)
        $steppablePipeline.Begin($PSCmdlet)
    } catch {
        throw
    }
}

process {
    try {
        $steppablePipeline.Process($_)
    } catch {
        throw
    }
}

end {
    try {
        $steppablePipeline.End()
    } catch {
        throw
    }
}
}