Az.Migrate

2.4.0

Migrate.Autorest/custom/New-AzMigrateHCIServerReplication.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

Starts replication for the specified server.

.Description

The New-AzMigrateHCIServerReplication cmdlet starts the replication for a particular discovered server in the Azure Migrate project.

.Link

https://learn.microsoft.com/powershell/module/az.migrate/new-azmigratehciserverreplication

#>

function New-AzMigrateHCIServerReplication {

    [OutputType([Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20210216Preview.IWorkflowModel])]

    [CmdletBinding(DefaultParameterSetName = 'ByIdDefaultUser', PositionalBinding = $false, SupportsShouldProcess, ConfirmImpact = 'Medium')]

    param(

        [Parameter(ParameterSetName = 'ByIdDefaultUser', Mandatory)]

        [Parameter(ParameterSetName = 'ByIdPowerUser', Mandatory)]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Path')]

        [System.String]

        # Specifies the machine ARM ID of the discovered server to be migrated.

        ${MachineId}, 

        [Parameter(Mandatory)]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Path')]

        [System.String]

        # Specifies the storage path ARM ID where the VMs will be stored.

        ${TargetStoragePathId},

        [Parameter()]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Path')]

        [System.Int32]

        # Specifies the number of CPU cores.

        ${TargetVMCPUCore},

        [Parameter(ParameterSetName = 'ByIdDefaultUser', Mandatory)]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Path')]

        [System.String]

        # Specifies the logical network ARM ID that the VMs will use. 

        ${TargetVirtualSwitchId},

        [Parameter(ParameterSetName = 'ByIdDefaultUser')]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Path')]

        [System.String]

        # Specifies the test logical network ARM ID that the VMs will use. 

        ${TargetTestVirtualSwitchId},

        [Parameter()]

        [ValidateSet("true" , "false")]

        [ArgumentCompleter( { "true" , "false" })]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Path')]

        [System.String]

        # Specifies if RAM is dynamic or not. 

        ${IsDynamicMemoryEnabled},

        [Parameter()]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Path')]

        [System.Int64]

        # Specifies the target RAM size in MB. 

        ${TargetVMRam},

        [Parameter(ParameterSetName = 'ByIdPowerUser', Mandatory)]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Path')]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20210216Preview.AzStackHCIDiskInput[]]

        # Specifies the disks on the source server to be included for replication.

        ${DiskToInclude},

        [Parameter(ParameterSetName = 'ByIdPowerUser', Mandatory)]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Path')]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20210216Preview.AzStackHCINicInput[]]

        # Specifies the NICs on the source server to be included for replication.

        ${NicToInclude},

        [Parameter(Mandatory)]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Path')]

        [System.String]

        # Specifies the target Resource Group Id where the migrated VM resources will reside.

        ${TargetResourceGroupId},

        [Parameter(Mandatory)]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Path')]

        [System.String]

        # Specifies the name of the VM to be created.

        ${TargetVMName},

        [Parameter(ParameterSetName = 'ByIdDefaultUser', Mandatory)]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Path')]

        [System.String]

        # Specifies the Operating System disk for the source server to be migrated.

        ${OSDiskID},

        [Parameter()]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Path')]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Runtime.DefaultInfo(Script = '(Get-AzContext).Subscription.Id')]

        [System.String]

        # Azure Subscription ID.

        ${SubscriptionId},

        [Parameter()]

        [Alias('AzureRMContext', 'AzureCredential')]

        [ValidateNotNull()]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Azure')]

        [System.Management.Automation.PSObject]

        # The credentials, account, tenant, and subscription used for communication with Azure.

        ${DefaultProfile},

        [Parameter(DontShow)]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Runtime')]

        [System.Management.Automation.SwitchParameter]

        # Wait for .NET debugger to attach

        ${Break},

        [Parameter(DontShow)]

        [ValidateNotNull()]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Runtime')]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Runtime.SendAsyncStep[]]

        # SendAsync Pipeline Steps to be appended to the front of the pipeline

        ${HttpPipelineAppend},

        [Parameter(DontShow)]

        [ValidateNotNull()]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Runtime')]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Runtime.SendAsyncStep[]]

        # SendAsync Pipeline Steps to be prepended to the front of the pipeline

        ${HttpPipelinePrepend},

        [Parameter(DontShow)]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Runtime')]

        [System.Uri]

        # The URI for the proxy server to use

        ${Proxy},

        [Parameter(DontShow)]

        [ValidateNotNull()]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Runtime')]

        [System.Management.Automation.PSCredential]

        # Credentials for a proxy server to use for the remote call

        ${ProxyCredential},

        [Parameter(DontShow)]

        [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Category('Runtime')]

        [System.Management.Automation.SwitchParameter]

        # Use the default credentials for the proxy

        ${ProxyUseDefaultCredentials}

    )

    process {

        Import-Module $PSScriptRoot\Helper\AzStackHCICommonSettings.ps1

        Import-Module $PSScriptRoot\Helper\CommonHelper.ps1

        CheckResourceGraphModuleDependency

        CheckResourcesModuleDependency

        $HasTargetVMCPUCore = $PSBoundParameters.ContainsKey('TargetVMCPUCore')

        $HasIsDynamicMemoryEnabled = $PSBoundParameters.ContainsKey('IsDynamicMemoryEnabled')

        if ($HasIsDynamicMemoryEnabled) {

            $isDynamicRamEnabled = [System.Convert]::ToBoolean($IsDynamicMemoryEnabled)

        }

        $HasTargetVMRam = $PSBoundParameters.ContainsKey('TargetVMRam')

        $HasTargetTestVirtualSwitchId = $PSBoundParameters.ContainsKey('TargetTestVirtualSwitchId')

        $parameterSet = $PSCmdlet.ParameterSetName

        $null = $PSBoundParameters.Remove('TargetVMCPUCore')

        $null = $PSBoundParameters.Remove('IsDynamicMemoryEnabled')

        $null = $PSBoundParameters.Remove('TargetVMRam')

        $null = $PSBoundParameters.Remove('DiskToInclude')

        $null = $PSBoundParameters.Remove('NicToInclude')

        $null = $PSBoundParameters.Remove('TargetResourceGroupId')

        $null = $PSBoundParameters.Remove('TargetVMName')

        $null = $PSBoundParameters.Remove('TargetVirtualSwitchId')

        $null = $PSBoundParameters.Remove('TargetTestVirtualSwitchId')

        $null = $PSBoundParameters.Remove('TargetStoragePathId')

        $null = $PSBoundParameters.Remove('OSDiskID')

        $null = $PSBoundParameters.Remove('MachineId')

        $null = $PSBoundParameters.Remove('WhatIf')

        $null = $PSBoundParameters.Remove('Confirm')

        $MachineIdArray = $MachineId.Split("/")

        $SiteType = $MachineIdArray[7]

        $SiteName = $MachineIdArray[8]

        $ResourceGroupName = $MachineIdArray[4]

        $MachineName = $MachineIdArray[10]

        if (($SiteType -ne $SiteTypes.HyperVSites) -and ($SiteType -ne $SiteTypes.VMwareSites)) {

            throw "Site type is not supported. Site type '$SiteType'. Check MachineId provided."

        }

        # Get the source site and the discovered machine

        $null = $PSBoundParameters.Add("ResourceGroupName", $ResourceGroupName)

        $null = $PSBoundParameters.Add("SiteName", $SiteName)

        $null = $PSBoundParameters.Add("MachineName", $MachineName)

        if ($SiteType -eq $SiteTypes.HyperVSites) {

            $instanceType = $AzStackHCIInstanceTypes.HyperVToAzStackHCI

            $machine = InvokeAzMigrateGetCommandWithRetries `

                -CommandName 'Az.Migrate.Internal\Get-AzMigrateHyperVMachine' `

                -Parameters $PSBoundParameters `

                -ErrorMessage "Machine '$MachineName' not found in resource group '$ResourceGroupName' and site '$SiteName'."

            $null = $PSBoundParameters.Remove('MachineName')

            $siteObject = InvokeAzMigrateGetCommandWithRetries `

                -CommandName 'Az.Migrate.Internal\Get-AzMigrateHyperVSite' `

                -Parameters $PSBoundParameters `

                -ErrorMessage "Machine site '$SiteName' with Type '$SiteType' not found."

        }

        elseif ($SiteType -eq $SiteTypes.VMwareSites) {

            $instanceType = $AzStackHCIInstanceTypes.VMwareToAzStackHCI

            $machine = InvokeAzMigrateGetCommandWithRetries `

                -CommandName 'Az.Migrate.Internal\Get-AzMigrateMachine' `

                -Parameters $PSBoundParameters `

                -ErrorMessage "Machine '$MachineName' not found in resource group '$ResourceGroupName' and site '$SiteName'."

            $null = $PSBoundParameters.Remove('MachineName')

            $siteObject = InvokeAzMigrateGetCommandWithRetries `

                -CommandName 'Az.Migrate\Get-AzMigrateSite' `

                -Parameters $PSBoundParameters `

                -ErrorMessage "Machine site '$SiteName' with Type '$SiteType' not found."

        }

        # $siteObject is not null or exception would have been thrown

        $ProjectName = $siteObject.DiscoverySolutionId.Split("/")[8]

        $null = $PSBoundParameters.Remove('SiteName')

        # Get the migrate solution.

        $amhSolutionName = "Servers-Migration-ServerMigration_DataReplication"

        $null = $PSBoundParameters.Add("Name", $amhSolutionName)

        $null = $PSBoundParameters.Add("MigrateProjectName", $ProjectName)

        $solution = InvokeAzMigrateGetCommandWithRetries `

            -CommandName 'Az.Migrate\Get-AzMigrateSolution' `

            -Parameters $PSBoundParameters `

            -ErrorMessage "No Data Replication Service Solution '$amhSolutionName' found in resource group '$ResourceGroupName' and project '$ProjectName'. Please verify your appliance setup."

        $null = $PSBoundParameters.Remove('ResourceGroupName')

        $null = $PSBoundParameters.Remove("Name")

        $null = $PSBoundParameters.Remove("MigrateProjectName")

        $VaultName = $solution.DetailExtendedDetail.AdditionalProperties.vaultId.Split("/")[8]

        if ([string]::IsNullOrEmpty($VaultName)) {

            throw "Azure Migrate Project not configured: missing replication vault. Setup Azure Migrate Project and run the Initialize-AzMigrateHCIReplicationInfrastructure script before proceeding."

        }

        # Get fabrics and appliances in the project

        $allFabrics = Az.Migrate\Get-AzMigrateHCIReplicationFabric -ResourceGroupName $ResourceGroupName

        foreach ($fabric in $allFabrics) {

            if ($fabric.Property.CustomProperty.MigrationSolutionId -ne $solution.Id) {

                continue

            }

            if ($fabric.Property.CustomProperty.InstanceType -ceq $FabricInstanceTypes.HyperVInstance) {

                $sourceFabric = $fabric

            }

            elseif ($fabric.Property.CustomProperty.InstanceType -ceq $FabricInstanceTypes.VmwareInstance) {

                $sourceFabric = $fabric

            }

            elseif ($fabric.Property.CustomProperty.InstanceType -ceq $FabricInstanceTypes.AzStackHCIInstance) {

                $targetFabric = $fabric

            }

        }

        if ($null -eq $sourceFabric) {

            throw "No connected source appliances are found. Kindly deploy an appliance by completing the Discover step of the migration jounery on the source cluster."

        }

        if ($null -eq $targetFabric) {

            throw "A target appliance is not available for the target cluster. Deploy and configure a new appliance for the cluster, or select a different cluster."

        }

        # Get Source and Target Dras

        $sourceDras = InvokeAzMigrateGetCommandWithRetries `

            -CommandName 'Az.Migrate.Internal\Get-AzMigrateDra' `

            -Parameters @{ FabricName = $sourceFabric.Name; ResourceGroupName = $ResourceGroupName } `

            -ErrorMessage "No connected source appliances are found. Kindly deploy an appliance by completing the Discover step of the migration jounery on the source cluster."

        $sourceDra = $sourceDras[0]

        $targetDras = InvokeAzMigrateGetCommandWithRetries `

            -CommandName 'Az.Migrate.Internal\Get-AzMigrateDra' `

            -Parameters @{ FabricName = $targetFabric.Name; ResourceGroupName = $ResourceGroupName } `

            -ErrorMessage "No connected target appliances are found. Deploy and configure a new appliance for the target cluster, or select a different cluster."

        $targetDra = $targetDras[0]

        # Validate Policy

        $policyName = $vaultName + $instanceType + "policy"

        $policy = InvokeAzMigrateGetCommandWithRetries `

            -CommandName 'Az.Migrate.Internal\Get-AzMigratePolicy' `

            -Parameters @{ ResourceGroupName = $ResourceGroupName; Name = $policyName; VaultName = $vaultName; SubscriptionId = $SubscriptionId } `

            -ErrorMessage "The replication policy '$policyName' not found. The replication infrastructure is not initialized. Run the Initialize-AzMigrateHCIReplicationInfrastructure script again."

        # Validate Replication Extension

        $replicationExtensionName = ($sourceFabric.Id -split '/')[-1] + "-" + ($targetFabric.Id -split '/')[-1] + "-MigReplicationExtn"

        $replicationExtension = InvokeAzMigrateGetCommandWithRetries `

            -CommandName 'Az.Migrate.Internal\Get-AzMigrateReplicationExtension' `

            -Parameters @{ ResourceGroupName = $ResourceGroupName; Name = $replicationExtensionName; VaultName = $vaultName; SubscriptionId = $SubscriptionId } `

            -ErrorMessage "The replication extension '$replicationExtensionName' not found. The replication infrastructure is not initialized. Run the Initialize-AzMigrateHCIReplicationInfrastructure script again."

        $targetClusterId = $targetFabric.Property.CustomProperty.Cluster.ResourceName

        $targetClusterIdArray = $targetClusterId.Split("/")

        $targetSubscription = $targetClusterIdArray[2]

        # Get Target cluster

        $hciClusterArgQuery = GetHCIClusterARGQuery -HCIClusterID $targetClusterId

        $targetCluster = Az.ResourceGraph\Search-AzGraph -Query $hciClusterArgQuery -Subscription $targetSubscription

        if ($null -eq $targetCluster) {

            throw "Validate target cluster with id '$targetClusterId' exists. Check ARC resource bridge is running on this cluster."

        }

        # Get source appliance RunAsAccount

        if ($SiteType -eq $SiteTypes.HyperVSites) {

            $runAsAccounts = InvokeAzMigrateGetCommandWithRetries `

                -CommandName 'Az.Migrate.Internal\Get-AzMigrateHyperVRunAsAccount' `

                -Parameters @{ ResourceGroupName = $ResourceGroupName; SiteName = $SiteName; SubscriptionId = $SubscriptionId } `

                -ErrorMessage "No run as account found for site '$SiteName'."

            $runAsAccount = $runAsAccounts | Where-Object { $_.CredentialType -eq $RunAsAccountCredentialTypes.HyperVFabric }

        }

        elseif ($SiteType -eq $SiteTypes.VMwareSites) {

            $runAsAccounts = InvokeAzMigrateGetCommandWithRetries `

                -CommandName 'Az.Migrate\Get-AzMigrateRunAsAccount' `

                -Parameters @{ ResourceGroupName = $ResourceGroupName; SiteName = $SiteName; SubscriptionId = $SubscriptionId } `

                -ErrorMessage "No run as account found for site '$SiteName'."

            $runAsAccount = $runAsAccounts | Where-Object { $_.CredentialType -eq $RunAsAccountCredentialTypes.VMwareFabric }

        }

        # Validate TargetVMName

        if ($TargetVMName.length -gt 64 -or $TargetVMName.length -eq 0) {

            throw "The target virtual machine name must be between 1 and 64 characters long."

        }

        Import-Module Az.Resources

        $vmId = $customProperties.TargetResourceGroupId + "/providers/Microsoft.Compute/virtualMachines/" + $TargetVMName

        $VMNamePresentInRg = Get-AzResource -ResourceId $vmId -ErrorVariable notPresent -ErrorAction SilentlyContinue

        if ($VMNamePresentInRg) {

            throw "The target virtual machine name must be unique in the target resource group."

        }

        if ($TargetVMName -notmatch "^[^_\W][a-zA-Z0-9\-]{0,63}(?<![-._])$") {

            throw "The target virtual machine name must begin with a letter or number, and can contain only letters, numbers, or hyphens(-). The names cannot contain special characters \/""[]:|<>+=;,?*@&, whitespace, or begin with '_' or end with '.' or '-'."

        }

        if (IsReservedOrTrademarked($TargetVMName)) {

            throw "The target virtual machine name '$TargetVMName' or part of the name is a trademarked or reserved word."

        }

        $protectedItemProperties = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20210216Preview.ProtectedItemModelProperties]::new()

        $protectedItemProperties.PolicyName = $policyName

        $protectedItemProperties.ReplicationExtensionName = $replicationExtensionName

        if ($SiteType -eq $SiteTypes.HyperVSites) {     

            $customProperties = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20210216Preview.HyperVToAzStackHCIProtectedItemModelCustomProperties]::new()

            $isSourceDynamicMemoryEnabled = $machine.IsDynamicMemoryEnabled

        }

        elseif ($SiteType -eq $SiteTypes.VMwareSites) {  

            $customProperties = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20210216Preview.VMwareToAzStackHCIProtectedItemModelCustomProperties]::new()

            $isSourceDynamicMemoryEnabled = $false

        }

        $customProperties.InstanceType = $instanceType

        $customProperties.CustomLocationRegion = $targetCluster.CustomLocationRegion

        $customProperties.FabricDiscoveryMachineId = $machine.Id

        $customProperties.RunAsAccountId = $runAsAccount.Id

        $customProperties.SourceDraName = $sourceDra.Name

        $customProperties.StorageContainerId = $TargetStoragePathId

        $customProperties.TargetArcClusterCustomLocationId = $targetCluster.CustomLocation

        $customProperties.TargetDraName = $targetDra.Name

        $customProperties.TargetHciClusterId = $targetClusterId

        $customProperties.TargetResourceGroupId = $TargetResourceGroupId

        $customProperties.TargetVMName = $TargetVMName

        $customProperties.HyperVGeneration = if ($SiteType -eq $SiteTypes.HyperVSites) { $machine.Generation } else { "1" }

        $customProperties.TargetCpuCore = if ($HasTargetVMCPUCore) { $TargetVMCPUCore } else { $machine.NumberOfProcessorCore }

        $customProperties.IsDynamicRam = if ($HasIsDynamicMemoryEnabled) { $isDynamicRamEnabled } else {  $isSourceDynamicMemoryEnabled }

        # Validate TargetVMRam

        if ($HasTargetVMRam) {

            # TargetVMRam needs to be greater than 0

            if ($TargetVMRam -le 0) {

                throw "Specify target RAM greater than 0"    

            }

            $customProperties.TargetMemoryInMegaByte = $TargetVMRam 

        }

        else

        {

            $customProperties.TargetMemoryInMegaByte = [System.Math]::Max($machine.AllocatedMemoryInMB, $RAMConfig.MinTargetMemoryInMB)

        }

        # Construct default dynamic memory config

        $memoryConfig = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20210216Preview.ProtectedItemDynamicMemoryConfig]::new()

        $memoryConfig.MinimumMemoryInMegaByte = [System.Math]::Min($customProperties.TargetMemoryInMegaByte, $RAMConfig.DefaultMinDynamicMemoryInMB)

        $memoryConfig.MaximumMemoryInMegaByte = [System.Math]::Max($customProperties.TargetMemoryInMegaByte, $RAMConfig.DefaultMaxDynamicMemoryInMB)

        $memoryConfig.TargetMemoryBufferPercentage = $RAMConfig.DefaultTargetMemoryBufferPercentage

        $customProperties.DynamicMemoryConfig = $memoryConfig

        # Disks and Nics

        [PSCustomObject[]]$disks = @()

        [PSCustomObject[]]$nics = @()

        if ($parameterSet -match 'DefaultUser') {

            if ($SiteType -eq $SiteTypes.HyperVSites) {

                $osDisk = $machine.Disk | Where-Object { $_.InstanceId -eq $OSDiskID }

                if ($null -eq $osDisk) {

                    throw "No Disk found with InstanceId '$OSDiskID' from discovered machine disks."

                }

                $diskName = Split-Path $osDisk.Path -leaf

                if (IsReservedOrTrademarked($diskName)) {

                    throw "The disk name '$diskName' or part of the name is a trademarked or reserved word."

                }

            }

            elseif ($SiteType -eq $SiteTypes.VMwareSites) {  

                $osDisk = $machine.Disk | Where-Object { $_.Uuid -eq $OSDiskID }

                if ($null -eq $osDisk) {

                    throw "No Disk found with Uuid '$OSDiskID' from discovered machine disks."

                }

                $diskName = Split-Path $osDisk.Path -leaf

                if (IsReservedOrTrademarked($diskName)) {

                    throw "The disk name '$diskName' or part of the name is a trademarked or reserved word."

                }

            }

            foreach ($sourceDisk in $machine.Disk) {

                $diskId = if ($SiteType -eq $SiteTypes.HyperVSites) { $sourceDisk.InstanceId } else { $sourceDisk.Uuid }

                $diskSize = if ($SiteType -eq $SiteTypes.HyperVSites) { $sourceDisk.MaxSizeInByte } else { $sourceDisk.MaxSizeInBytes }

                $DiskObject = [PSCustomObject]@{

                    DiskId         = $diskId

                    DiskSizeGb     = [long] [Math]::Ceiling($diskSize / 1GB)

                    DiskFileFormat = "VHDX"

                    IsDynamic      = $true

                    IsOSDisk       = $diskId -eq $OSDiskID

                }

                $disks += $DiskObject

            }

            foreach ($sourceNic in $machine.NetworkAdapter) {

                $NicObject = [PSCustomObject]@{

                    NicId                    = $sourceNic.NicId

                    TargetNetworkId          = $TargetVirtualSwitchId

                    TestNetworkId            = if ($HasTargetTestVirtualSwitchId) { $TargetTestVirtualSwitchId } else { $TargetVirtualSwitchId }

                    SelectionTypeForFailover = $VMNicSelection.SelectedByUser

                }

                $nics += $NicObject

            }

        }

        else

        {

            # PowerUser

            if ($null -eq $DiskToInclude -or $DiskToInclude.length -eq 0) {

                throw "Invalid DiskToInclude. At least one disk is required."

            }

            # Validate OSDisk is set.

            $osDisk = $DiskToInclude | Where-Object { $_.IsOSDisk }

            if (($null -eq $osDisk) -or ($osDisk.length -ne 1)) {

                throw "Invalid DiskToInclude. One and only one disk must be set as OS Disk."

            }

            # Validate DiskToInclude

            [PSCustomObject[]]$uniqueDisks = @()

            foreach ($disk in $DiskToInclude) {

                if ($SiteType -eq $SiteTypes.HyperVSites) {

                    $discoveredDisk = $machine.Disk | Where-Object { $_.InstanceId -eq $disk.DiskId }

                    if ($null -eq $discoveredDisk) {

                        throw "No Disk found with InstanceId '$($disk.DiskId)' from discovered machine disks."

                    }

                }

                elseif ($SiteType -eq $SiteTypes.VMwareSites) {  

                    $discoveredDisk = $machine.Disk | Where-Object { $_.Uuid -eq $disk.DiskId }

                    if ($null -eq $discoveredDisk) {

                        throw "No Disk found with Uuid '$($disk.DiskId)' from discovered machine disks."

                    }

                }

                $diskName = Split-Path -Path $discoveredDisk.Path -Leaf

                if (IsReservedOrTrademarked($diskName)) {

                    throw "The disk name '$diskName' or part of the name is a trademarked or reserved word."

                }

                if ($uniqueDisks.Contains($disk.DiskId)) {

                    throw "The disk id '$($disk.DiskId)' is already taken."

                }

                $uniqueDisks += $disk.DiskId

                $htDisk = @{}

                $disk.PSObject.Properties | ForEach-Object { $htDisk[$_.Name] = $_.Value }

                $disks += [PSCustomObject]$htDisk

            }

            # Validate NicToInclude

            [PSCustomObject[]]$uniqueNics = @()

            foreach ($nic in $NicToInclude) {

                $discoveredNic = $machine.NetworkAdapter | Where-Object { $_.NicId -eq $nic.NicId }

                if ($null -eq $discoveredNic) {

                    throw "The Nic id '$($nic.NicId)' is not found."

                }

                if ($uniqueNics.Contains($nic.NicId)) {

                    throw "The Nic id '$($nic.NicId)' is already included. Please remove the duplicate entry and try again."

                }

                $uniqueNics += $nic.NicId

                $htNic = @{}

                $nic.PSObject.Properties | ForEach-Object { $htNic[$_.Name] = $_.Value }

                if ($htNic.SelectionTypeForFailover -eq $VMNicSelection.SelectedByUser -and

                    [string]::IsNullOrEmpty($htNic.TargetNetworkId)) {

                    throw "TargetVirtualSwitchId is required when the NIC '$($htNic.NicId)' is to be CreateAtTarget. Please utilize the New-AzMigrateHCINicMappingObject command to properly create a Nic mapping object."

                }

                $nics += [PSCustomObject]$htNic

            }

        }

        if ($SiteType -eq $SiteTypes.HyperVSites) {     

            $customProperties.DisksToInclude = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20210216Preview.HyperVToAzStackHCIDiskInput[]]$disks

            $customProperties.NicsToInclude = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20210216Preview.HyperVToAzStackHCINicInput[]]$nics

        }

        elseif ($SiteType -eq $SiteTypes.VMwareSites) {     

            $customProperties.DisksToInclude = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20210216Preview.VMwareToAzStackHCIDiskInput[]]$disks

            $customProperties.NicsToInclude = [Microsoft.Azure.PowerShell.Cmdlets.Migrate.Models.Api20210216Preview.VMwareToAzStackHCINicInput[]]$nics

        }

        $protectedItemProperties.CustomProperty = $customProperties

        if ($PSCmdlet.ShouldProcess($MachineId, "Replicate VM.")) {

            $null = $PSBoundParameters.Add('ResourceGroupName', $ResourceGroupName)

            $null = $PSBoundParameters.Add('VaultName', $vaultName)

            $null = $PSBoundParameters.Add('Name', $MachineName)

            $null = $PSBoundParameters.Add('Property', $protectedItemProperties)

            $null = $PSBoundParameters.Add('NoWait', $true)

            $operation = Az.Migrate.Internal\New-AzMigrateProtectedItem @PSBoundParameters

            $jobName = $operation.Target.Split("/")[-1].Split("?")[0]

            $null = $PSBoundParameters.Remove('Name')  

            $null = $PSBoundParameters.Remove('Property')

            $null = $PSBoundParameters.Remove('NoWait')

            $null = $PSBoundParameters.Add('JobName', $jobName)

            return Az.Migrate.Internal\Get-AzMigrateWorkflow @PSBoundParameters

        }

    }

}

# SIG # Begin signature block

# MIInvwYJKoZIhvcNAQcCoIInsDCCJ6wCAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCB5V8GbfGtIrD31

# YPUfUIsfx3h9qIBEmxwvbCOy8Sg+vqCCDXYwggX0MIID3KADAgECAhMzAAADrzBA

# DkyjTQVBAAAAAAOvMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjMxMTE2MTkwOTAwWhcNMjQxMTE0MTkwOTAwWjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQDOS8s1ra6f0YGtg0OhEaQa/t3Q+q1MEHhWJhqQVuO5amYXQpy8MDPNoJYk+FWA

# hePP5LxwcSge5aen+f5Q6WNPd6EDxGzotvVpNi5ve0H97S3F7C/axDfKxyNh21MG

# 0W8Sb0vxi/vorcLHOL9i+t2D6yvvDzLlEefUCbQV/zGCBjXGlYJcUj6RAzXyeNAN

# xSpKXAGd7Fh+ocGHPPphcD9LQTOJgG7Y7aYztHqBLJiQQ4eAgZNU4ac6+8LnEGAL

# go1ydC5BJEuJQjYKbNTy959HrKSu7LO3Ws0w8jw6pYdC1IMpdTkk2puTgY2PDNzB

# tLM4evG7FYer3WX+8t1UMYNTAgMBAAGjggFzMIIBbzAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQURxxxNPIEPGSO8kqz+bgCAQWGXsEw

# RQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEW

# MBQGA1UEBRMNMjMwMDEyKzUwMTgyNjAfBgNVHSMEGDAWgBRIbmTlUAXTgqoXNzci

# tW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3JsMGEG

# CCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNyb3NvZnQu

# Y29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3J0

# MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBAISxFt/zR2frTFPB45Yd

# mhZpB2nNJoOoi+qlgcTlnO4QwlYN1w/vYwbDy/oFJolD5r6FMJd0RGcgEM8q9TgQ

# 2OC7gQEmhweVJ7yuKJlQBH7P7Pg5RiqgV3cSonJ+OM4kFHbP3gPLiyzssSQdRuPY

# 1mIWoGg9i7Y4ZC8ST7WhpSyc0pns2XsUe1XsIjaUcGu7zd7gg97eCUiLRdVklPmp

# XobH9CEAWakRUGNICYN2AgjhRTC4j3KJfqMkU04R6Toyh4/Toswm1uoDcGr5laYn

# TfcX3u5WnJqJLhuPe8Uj9kGAOcyo0O1mNwDa+LhFEzB6CB32+wfJMumfr6degvLT

# e8x55urQLeTjimBQgS49BSUkhFN7ois3cZyNpnrMca5AZaC7pLI72vuqSsSlLalG

# OcZmPHZGYJqZ0BacN274OZ80Q8B11iNokns9Od348bMb5Z4fihxaBWebl8kWEi2O

# PvQImOAeq3nt7UWJBzJYLAGEpfasaA3ZQgIcEXdD+uwo6ymMzDY6UamFOfYqYWXk

# ntxDGu7ngD2ugKUuccYKJJRiiz+LAUcj90BVcSHRLQop9N8zoALr/1sJuwPrVAtx

# HNEgSW+AKBqIxYWM4Ev32l6agSUAezLMbq5f3d8x9qzT031jMDT+sUAoCw0M5wVt

# CUQcqINPuYjbS1WgJyZIiEkBMIIHejCCBWKgAwIBAgIKYQ6Q0gAAAAAAAzANBgkq

# hkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x

# EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv

# bjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5

# IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEwOTA5WjB+MQswCQYDVQQG

# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG

# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYDVQQDEx9NaWNyb3NvZnQg

# Q29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC

# CgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+laUKq4BjgaBEm6f8MMHt03

# a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc6Whe0t+bU7IKLMOv2akr

# rnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4Ddato88tt8zpcoRb0Rrrg

# OGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+lD3v++MrWhAfTVYoonpy

# 4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nkkDstrjNYxbc+/jLTswM9

# sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6A4aN91/w0FK/jJSHvMAh

# dCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmdX4jiJV3TIUs+UsS1Vz8k

# A/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL5zmhD+kjSbwYuER8ReTB

# w3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zdsGbiwZeBe+3W7UvnSSmn

# Eyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3T8HhhUSJxAlMxdSlQy90

# lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS4NaIjAsCAwEAAaOCAe0w

# ggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRIbmTlUAXTgqoXNzcitW2o

# ynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYD

# VR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBDuRQFTuHqp8cx0SOJNDBa

# BgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2Ny

# bC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3JsMF4GCCsG

# AQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3dy5taWNyb3NvZnQuY29t

# L3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3J0MIGfBgNV

# HSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEFBQcCARYzaHR0cDovL3d3

# dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1hcnljcHMuaHRtMEAGCCsG

# AQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkAYwB5AF8AcwB0AGEAdABl

# AG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn8oalmOBUeRou09h0ZyKb

# C5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7v0epo/Np22O/IjWll11l

# hJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0bpdS1HXeUOeLpZMlEPXh6

# I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/KmtYSWMfCWluWpiW5IP0

# wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvyCInWH8MyGOLwxS3OW560

# STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBpmLJZiWhub6e3dMNABQam

# ASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJihsMdYzaXht/a8/jyFqGa

# J+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYbBL7fQccOKO7eZS/sl/ah

# XJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbSoqKfenoi+kiVH6v7RyOA

# 9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sLgOppO6/8MO0ETI7f33Vt

# Y5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtXcVZOSEXAQsmbdlsKgEhr

# /Xmfwb1tbWrJUnMTDXpQzTGCGZ8wghmbAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw

# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp

# Z25pbmcgUENBIDIwMTECEzMAAAOvMEAOTKNNBUEAAAAAA68wDQYJYIZIAWUDBAIB

# BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO

# MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIGWaTsqZ9cfVSwIaKAKIYND7

# 0iAcyh5IMnuArrKuKve7MEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A

# cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB

# BQAEggEAT3Yn60eHmYmq11w/GpbZTuqgBXkcPrHUwrhNSXKzsy0/GmbKiJj5EcvP

# hpfQGH8UxNSQ9487R13QFHkhPajZHV1NyjeeLIoTKuctE+FFJfks+hiLLt1DNXi5

# dPdqOJ8tdfT/rD0p/k9oA0phsZvjj6AcbdnP8+UVoDwPHG+kxSMyE5HTyKlVJDE3

# OQRBsVTcJDY0psR+HOlYzQcjgWscV4pyHPhccs47fJC07QARgvdOwFBhaew3EaA9

# 0dVdfIQ/8UfjBE4MpnlejhVw3FN7ZGxsXcDa6Z/6oph5YwgQmLcHVdZUmQ0kOPp2

# U9vJp3nZp6SwCexnrIk1Di4i0YhGjqGCFykwghclBgorBgEEAYI3AwMBMYIXFTCC

# FxEGCSqGSIb3DQEHAqCCFwIwghb+AgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFZBgsq

# hkiG9w0BCRABBKCCAUgEggFEMIIBQAIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl

# AwQCAQUABCAJevdJ1gEN8g34MxCKTugvEF94Ku82a0HTSGxR/fwXuQIGZnL0zkQi

# GBMyMDI0MDcwNDA4MzA0OS4xNjZaMASAAgH0oIHYpIHVMIHSMQswCQYDVQQGEwJV

# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE

# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJl

# bGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxJjAkBgNVBAsTHVRoYWxlcyBUU1MgRVNO

# Ojg2REYtNEJCQy05MzM1MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBT

# ZXJ2aWNloIIReDCCBycwggUPoAMCAQICEzMAAAHdXVcdldStqhsAAQAAAd0wDQYJ

# KoZIhvcNAQELBQAwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x

# EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv

# bjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwHhcNMjMx

# MDEyMTkwNzA5WhcNMjUwMTEwMTkwNzA5WjCB0jELMAkGA1UEBhMCVVMxEzARBgNV

# BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv

# c29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxhbmQgT3Bl

# cmF0aW9ucyBMaW1pdGVkMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjo4NkRGLTRC

# QkMtOTMzNTElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZTCC

# AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAKhOA5RE6i53nHURH4lnfKLp

# +9JvipuTtctairCxMUSrPSy5CWK2DtriQP+T52HXbN2g7AktQ1pQZbTDGFzK6d03

# vYYNrCPuJK+PRsP2FPVDjBXy5mrLRFzIHHLaiAaobE5vFJuoxZ0ZWdKMCs8acjhH

# UmfaY+79/CR7uN+B4+xjJqwvdpU/mp0mAq3earyH+AKmv6lkrQN8zgrcbCgHwsqv

# vqT6lEFqYpi7uKn7MAYbSeLe0pMdatV5EW6NVnXMYOTRKuGPfyfBKdShualLo88k

# G7qa2mbA5l77+X06JAesMkoyYr4/9CgDFjHUpcHSODujlFBKMi168zRdLerdpW0b

# BX9EDux2zBMMaEK8NyxawCEuAq7++7ktFAbl3hUKtuzYC1FUZuUl2Bq6U17S4CKs

# qR3itLT9qNcb2pAJ4jrIDdll5Tgoqef5gpv+YcvBM834bXFNwytd3ujDD24P9Dd8

# xfVJvumjsBQQkK5T/qy3HrQJ8ud1nHSvtFVi5Sa/ubGuYEpS8gF6GDWN5/KbveFk

# dsoTVIPo8pkWhjPs0Q7nA5+uBxQB4zljEjKz5WW7BA4wpmFm24fhBmRjV4Nbp+n7

# 8cgAjvDSfTlA6DYBcv2kx1JH2dIhaRnSeOXePT6hMF0Il598LMu0rw35ViUWcAQk

# UNUTxRnqGFxz5w+ZusMDAgMBAAGjggFJMIIBRTAdBgNVHQ4EFgQUbqL1toyPUdpF

# yyHSDKWj0I4lw/EwHwYDVR0jBBgwFoAUn6cVXQBeYl2D9OXSZacbUzUZ6XIwXwYD

# VR0fBFgwVjBUoFKgUIZOaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9j

# cmwvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3JsMGwG

# CCsGAQUFBwEBBGAwXjBcBggrBgEFBQcwAoZQaHR0cDovL3d3dy5taWNyb3NvZnQu

# Y29tL3BraW9wcy9jZXJ0cy9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIw

# MjAxMCgxKS5jcnQwDAYDVR0TAQH/BAIwADAWBgNVHSUBAf8EDDAKBggrBgEFBQcD

# CDAOBgNVHQ8BAf8EBAMCB4AwDQYJKoZIhvcNAQELBQADggIBAC5U2bINLgXIHWbM

# cqVuf9jkUT/K8zyLBvu5h8JrqYR2z/eaO2yo1Ooc9Shyvxbe9GZDu7kkUzxSyJ1I

# ZksZZw6FDq6yZNT3PEjAEnREpRBL8S+mbXg+O4VLS0LSmb8XIZiLsaqZ0fDEcv3H

# eA+/y/qKnCQWkXghpaEMwGMQzRkhGwcGdXr1zGpQ7HTxvfu57xFxZX1MkKnWFENJ

# 6urd+4teUgXj0ngIOx//l3XMK3Ht8T2+zvGJNAF+5/5qBk7nr079zICbFXvxtidN

# N5eoXdW+9rAIkS+UGD19AZdBrtt6dZ+OdAquBiDkYQ5kVfUMKS31yHQOGgmFxuCO

# zTpWHalrqpdIllsy8KNsj5U9sONiWAd9PNlyEHHbQZDmi9/BNlOYyTt0YehLbDov

# mZUNazk79Od/A917mqCdTqrExwBGUPbMP+/vdYUqaJspupBnUtjOf/76DAhVy8e/

# e6zR98PkplmliO2brL3Q3rD6+ZCVdrGM9Rm6hUDBBkvYh+YjmGdcQ5HB6WT9Rec8

# +qDHmbhLhX4Zdaard5/OXeLbgx2f7L4QQQj3KgqjqDOWInVhNE1gYtTWLHe4882d

# /k7Lui0K1g8EZrKD7maOrsJLKPKlegceJ9FCqY1sDUKUhRa0EHUW+ZkKLlohKrS7

# FwjdrINWkPBgbQznCjdE2m47QjTbMIIHcTCCBVmgAwIBAgITMwAAABXF52ueAptJ

# mQAAAAAAFTANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgT

# Cldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29m

# dCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNh

# dGUgQXV0aG9yaXR5IDIwMTAwHhcNMjEwOTMwMTgyMjI1WhcNMzAwOTMwMTgzMjI1

# WjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQD

# Ex1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDCCAiIwDQYJKoZIhvcNAQEB

# BQADggIPADCCAgoCggIBAOThpkzntHIhC3miy9ckeb0O1YLT/e6cBwfSqWxOdcjK

# NVf2AX9sSuDivbk+F2Az/1xPx2b3lVNxWuJ+Slr+uDZnhUYjDLWNE893MsAQGOhg

# fWpSg0S3po5GawcU88V29YZQ3MFEyHFcUTE3oAo4bo3t1w/YJlN8OWECesSq/XJp

# rx2rrPY2vjUmZNqYO7oaezOtgFt+jBAcnVL+tuhiJdxqD89d9P6OU8/W7IVWTe/d

# vI2k45GPsjksUZzpcGkNyjYtcI4xyDUoveO0hyTD4MmPfrVUj9z6BVWYbWg7mka9

# 7aSueik3rMvrg0XnRm7KMtXAhjBcTyziYrLNueKNiOSWrAFKu75xqRdbZ2De+JKR

# Hh09/SDPc31BmkZ1zcRfNN0Sidb9pSB9fvzZnkXftnIv231fgLrbqn427DZM9itu

# qBJR6L8FA6PRc6ZNN3SUHDSCD/AQ8rdHGO2n6Jl8P0zbr17C89XYcz1DTsEzOUyO

# ArxCaC4Q6oRRRuLRvWoYWmEBc8pnol7XKHYC4jMYctenIPDC+hIK12NvDMk2ZItb

# oKaDIV1fMHSRlJTYuVD5C4lh8zYGNRiER9vcG9H9stQcxWv2XFJRXRLbJbqvUAV6

# bMURHXLvjflSxIUXk8A8FdsaN8cIFRg/eKtFtvUeh17aj54WcmnGrnu3tz5q4i6t

# AgMBAAGjggHdMIIB2TASBgkrBgEEAYI3FQEEBQIDAQABMCMGCSsGAQQBgjcVAgQW

# BBQqp1L+ZMSavoKRPEY1Kc8Q/y8E7jAdBgNVHQ4EFgQUn6cVXQBeYl2D9OXSZacb

# UzUZ6XIwXAYDVR0gBFUwUzBRBgwrBgEEAYI3TIN9AQEwQTA/BggrBgEFBQcCARYz

# aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9Eb2NzL1JlcG9zaXRvcnku

# aHRtMBMGA1UdJQQMMAoGCCsGAQUFBwMIMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIA

# QwBBMAsGA1UdDwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNX2

# VsuP6KJcYmjRPZSQW9fOmhjEMFYGA1UdHwRPME0wS6BJoEeGRWh0dHA6Ly9jcmwu

# bWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dF8yMDEw

# LTA2LTIzLmNybDBaBggrBgEFBQcBAQROMEwwSgYIKwYBBQUHMAKGPmh0dHA6Ly93

# d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYt

# MjMuY3J0MA0GCSqGSIb3DQEBCwUAA4ICAQCdVX38Kq3hLB9nATEkW+Geckv8qW/q

# XBS2Pk5HZHixBpOXPTEztTnXwnE2P9pkbHzQdTltuw8x5MKP+2zRoZQYIu7pZmc6

# U03dmLq2HnjYNi6cqYJWAAOwBb6J6Gngugnue99qb74py27YP0h1AdkY3m2CDPVt

# I1TkeFN1JFe53Z/zjj3G82jfZfakVqr3lbYoVSfQJL1AoL8ZthISEV09J+BAljis

# 9/kpicO8F7BUhUKz/AyeixmJ5/ALaoHCgRlCGVJ1ijbCHcNhcy4sa3tuPywJeBTp

# kbKpW99Jo3QMvOyRgNI95ko+ZjtPu4b6MhrZlvSP9pEB9s7GdP32THJvEKt1MMU0

# sHrYUP4KWN1APMdUbZ1jdEgssU5HLcEUBHG/ZPkkvnNtyo4JvbMBV0lUZNlz138e

# W0QBjloZkWsNn6Qo3GcZKCS6OEuabvshVGtqRRFHqfG3rsjoiV5PndLQTHa1V1QJ

# sWkBRH58oWFsc/4Ku+xBZj1p/cvBQUl+fpO+y/g75LcVv7TOPqUxUYS8vwLBgqJ7

# Fx0ViY1w/ue10CgaiQuPNtq6TPmb/wrpNPgkNWcr4A245oyZ1uEi6vAnQj0llOZ0

# dFtq0Z4+7X6gMTN9vMvpe784cETRkPHIqzqKOghif9lwY1NNje6CbaUFEMFxBmoQ

# tB1VM1izoXBm8qGCAtQwggI9AgEBMIIBAKGB2KSB1TCB0jELMAkGA1UEBhMCVVMx

# EzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoT

# FU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxh

# bmQgT3BlcmF0aW9ucyBMaW1pdGVkMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVTTjo4

# NkRGLTRCQkMtOTMzNTElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vy

# dmljZaIjCgEBMAcGBSsOAwIaAxUANiNHGWXbNaDPxnyiDbEOciSjFhCggYMwgYCk

# fjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQD

# Ex1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQUFAAIF

# AOowj4gwIhgPMjAyNDA3MDQxMTAzMzZaGA8yMDI0MDcwNTExMDMzNlowdDA6Bgor

# BgEEAYRZCgQBMSwwKjAKAgUA6jCPiAIBADAHAgEAAgIBjjAHAgEAAgIR8TAKAgUA

# 6jHhCAIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIBAAID

# B6EgoQowCAIBAAIDAYagMA0GCSqGSIb3DQEBBQUAA4GBAGBFti61qyDwU8ya675n

# /dq7403ujbf3sczBWiWKxrrwCTXiIbrATTAHo+J26ZdNkEeTInsfnKCA0oTR/K9U

# HLbEsMy60Of0366n7OtES2VQjEOXU2zxAa+ag1iLLSRmO3hrtNxkSQJBjvYOLCcR

# /YOLSDvVaKNxWpxlDeI+ChVBMYIEDTCCBAkCAQEwgZMwfDELMAkGA1UEBhMCVVMx

# EzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoT

# FU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUt

# U3RhbXAgUENBIDIwMTACEzMAAAHdXVcdldStqhsAAQAAAd0wDQYJYIZIAWUDBAIB

# BQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0BCQQx

# IgQgHpEFzga1L7D7Wct/tijPBDS6v0fPii7pWwa6bhf4n34wgfoGCyqGSIb3DQEJ

# EAIvMYHqMIHnMIHkMIG9BCBh/w4tmmWsT3iZnHtH0Vk37UCN02lRxY+RiON6wDFj

# ZjCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw

# DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# JjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAAB3V1X

# HZXUraobAAEAAAHdMCIEIJ4kinE3QmDfY0TBhTP6a06FdBQtZcCuQUjitTRENUjd

# MA0GCSqGSIb3DQEBCwUABIICAD8pF2KuFiiSD3lE0DwW9aEek9lylHcItlXn/DLT

# Cu3MiRLKZ7OBUbN7JcIm7/qufZjKVIGWXRz2IbfmqiWvAIZgwoDyQfImKwLOJhlp

# GOsOnxqzlhgtMQrQRijNJm+XUYzwA2HzbydwwOEJS825BsjXC8sU9ax5fqLwTpSt

# 3qX+Dzwsreud+0ja3M38rk3jPAKJszqHJu6dE151H39w8rKZ5PvBHmDAtyX/rrhb

# LJa9zqcqvHIxHl2TFKY4Wjhu58uAWQI6AOHgjXL2ElAaE7B33z3EU9I7he6OhbkA

# 1uCpAK/+QDhOH4vpi+xaDU6MQFeT+GFxAAQ9x5ml7s7KgnOWxdkyHl1sV2VkKNc8

# wGE9UeKseMp+gAPqqULBAEHL6ZSHpIifxWt9IaDPtPICRMVPzUx2mYP8WAz9g3s1

# XXTsxP56dFRBT7KAQk/uKfZ2i/yzn4jzb+Q48r1CtkxzHR1gc/27iWqUxJSf4U4m

# KqUpmuNL4vXVl7WeYY6HYAQinIlxiUGg+NSKwsLVMnva+f5tEhZYuQdMW7aMokjr

# lPG11EQ5AWRWkefjO0y0Eqzd2QLphsDaJ6RhyoBOhGsCPUk0QdoWLEGa2ZXg6UJS

# 5vl0gtwo8T3t8MUuKFrxYX3MiorQeHnnLjYR0OB2CZ7VhKi+55zFL00s4IQlRy2F

# sbUa

# SIG # End signature block