AVSvSANUtils.ps1

<#PSScriptInfo
 
.VERSION 1.0
 
.GUID b28778e8-2fd5-4ab1-a4bd-8026dc75d14b
 
.AUTHOR K. Chris Nakagaki
 
.COMPANYNAME Microsoft
 
.COPYRIGHT (c) Microsoft. All rights reserved.
 
.DESCRIPTION PowerShell private functions for AVS Storage Policy manipulation
 
#>


Function New-AVSCommonStoragePolicy {
    <#
        .DESCRIPTION
            This function creates a new or overwrites an existing vSAN Storage Policy.
        .PARAMETER Name
            Name of Common Storage Policy
        .PARAMETER Description
            Default is None. Valid values are None, Site mirroring - stretched cluster, "None - keep data on Preferred (stretched cluster)", "None - keep data on Secondary (stretched cluster)", "None - stretched cluster"
        .PARAMETER Encryption
            To make an encryption common storage policy. Will require PostIOEncryption parameter.
        .PARAMETER PostIOEncryption
            Valid values are True or False. False encrypts VM prior to VAIO Filter. True encrypts VM after VAIO Filter.
        .PARAMETER StorageIO
            To make a storage IO common storage policy. Will require IOLimit, IOReservation, and IOShares parameters.
        .PARAMETER IOLimit
            TODO: Need to add more information about this parameter.
        .PARAMETER IOReservation
            TODO: Need to add more information about this parameter.
        .PARAMETER IOShares
            TODO: Need to add more information about this parameter.
        .EXAMPLE
            New-AVSCommonStoragePolicy -Name "Encryption" -Encryption -PostIOEncryption $true
        .EXAMPLE
            New-AVSCommonStoragePolicy -Name "StorageIO" -StorageIO -IOLimit 1000 -IOReservation 100 -IOShares 100
     
    #>

    
    [CmdletBinding(DefaultParameterSetName = "Encryption")]
    param (
        [Parameter(Mandatory = $true, ParameterSetName = "Encryption", Position = 0)]
        [switch]
        $Encryption,
    
        [Parameter(Mandatory = $true, ParameterSetName = "StorageIO", Position = 0)]
        [switch]
        $StorageIO,
    
        [Parameter(Mandatory = $true)]
        [string]
        $Name,
    
        [Parameter(Mandatory = $false)]
        [string]
        $Description,
    
        [Parameter(Mandatory = $true, ParameterSetName = 'Encryption')]
        [bool]
        $PostIOEncryption,
    
        [Parameter(Mandatory = $true, ParameterSetName = 'StorageIO')]
        [int]$IOLimit,
        [Parameter(Mandatory = $true, ParameterSetName = 'StorageIO')]
        [int]$IOReservation,
        [Parameter(Mandatory = $true, ParameterSetName = 'StorageIO')]
        [int]$IOShares
    )
    Begin {
        If ($Encryption) {
            $policyconstraintType = "ENCRYPTION"
            $policycategory = "DATA_SERVICE_POLICY" #Valid options are REQUIREMENT or RESOURCE or DATA_SERVICE_POLICY
            $policyresourceType = "STORAGE" #The only valid option, basically pointless
            $policydescription = $description
        }
        ElseIf ($StorageIO) {
            $policyconstraintType = "STORAGEIO"
            $policycategory = "DATA_SERVICE_POLICY" #Valid options are REQUIREMENT or RESOURCE or DATA_SERVICE_POLICY
            $policyresourceType = "STORAGE" #The only valid option, basically pointless
            $policydescription = $description
        }
        Else {
            Write-Error "Invalid Parameter Set"
            Return
        }
    }
    process {
        $serviceInstanceView = Get-SpbmView -Id "PbmServiceInstance-ServiceInstance"
        $spbmServiceContent = $serviceInstanceView.PbmRetrieveServiceContent()
        $spbmProfMgr = Get-SpbmView -Id $spbmServiceContent.ProfileManager
        $profilespec = new-object VMware.Spbm.Views.PbmCapabilityProfileCreateSpec
        $subprofile = new-object VMware.Spbm.Views.PbmCapabilitySubProfile
        switch ($policyconstraintType) {
            Encryption {
                $subprofile.Name = "Encryption sub-profile"
                $subprofile.Capability = New-Object VMware.Spbm.Views.PbmCapabilityInstance
                $subprofile.Capability[0].Id = New-Object VMware.Spbm.Views.PbmCapabilityMetadataUniqueId
                $subprofile.Capability[0].Id.Namespace = "vmwarevmcrypt"
                $subprofile.Capability[0].Id.Id = "vmwarevmcrypt@ENCRYPTION"
                $subprofile.Capability[0].Constraint = New-Object VMware.Spbm.Views.PbmCapabilityConstraintInstance
                $subprofile.Capability[0].Constraint[0].PropertyInstance = New-Object VMware.Spbm.Views.PbmCapabilityPropertyInstance
                $subprofile.Capability[0].Constraint[0].PropertyInstance[0].id = "AllowCleartextFilters" #AllowCleartextFilters only known valid value
                If ($PostIOEncryption) {
                    $subprofile.Capability[0].Constraint[0].PropertyInstance[0].value = "True" #String Value, not Boolean
                }
                Else {
                    $subprofile.Capability[0].Constraint[0].PropertyInstance[0].value = "False" #String Value, not Boolean
                }
            }
    
            StorageIO {
                $subprofile.Name = "SIOC sub-profile"
                $subprofile.Capability = New-Object VMware.Spbm.Views.PbmCapabilityInstance
                $subprofile.Capability[0].Id = New-Object VMware.Spbm.Views.PbmCapabilityMetadataUniqueId
                $subprofile.Capability[0].Id.Namespace = "spm"
                $subprofile.Capability[0].Id.Id = "spm@DATASTOREIOCONTROL"
                $subprofile.Capability[0].Constraint = New-Object VMware.Spbm.Views.PbmCapabilityConstraintInstance
                $Limit = New-Object VMware.Spbm.Views.PbmCapabilityPropertyInstance
                $Limit.id = "limit"
                $Limit.value = $IOLimit
                $Reservation = New-Object VMware.Spbm.Views.PbmCapabilityPropertyInstance
                $Reservation.id = "reservation"
                $Reservation.value = $IOReservation
                $Shares = New-Object VMware.Spbm.Views.PbmCapabilityPropertyInstance
                $Shares.id = "shares"
                $Shares.value = $IOShares
                $subprofile.Capability[0].Constraint[0].PropertyInstance = @($Limit, $Reservation, $Shares)
            }
        }
        $pbmprofileresourcetype = new-object vmware.spbm.views.PbmProfileResourceType
        $pbmprofileresourcetype.ResourceType = $policyresourceType
        $profileconstraints = new-object vmware.spbm.views.PbmCapabilitySubProfileConstraints
        $profileconstraints.SubProfiles = @($subprofile)
    
        $profilespec.ResourceType = $pbmprofileresourcetype
        $profilespec.Name = $Name
        $profilespec.Constraints = $profileconstraints
        $profilespec.Description = $policydescription
        $profilespec.Category = $policycategory
        $profileuniqueID = $spbmProfMgr.PbmCreate($profilespec)
        $profileuniqueID.UniqueId
    }
    
}
    

Function Get-AVSSPBMCapabilities {

    <#
            .DESCRIPTION
            This is meant to pull the capabilities of the SPBM service for application to storage profiles.
    #>

    Begin {
        $serviceInstanceView = Get-SpbmView -Id "PbmServiceInstance-ServiceInstance"
        $spbmServiceContent = $serviceInstanceView.PbmRetrieveServiceContent()
        $spbmProfMgr = Get-SpbmView -Id $spbmServiceContent.ProfileManager
        $pbmprofileresourcetype = new-object vmware.spbm.views.PbmProfileResourceType
        $pbmprofileresourcetype.ResourceType = "STORAGE"
        $spbmvendors = $spbmProfMgr.PbmFetchVendorInfo($null)
        $results = @()
    }
    
    Process {
        Foreach ($spbmvendor in $spbmvendors) {
            Foreach ($namespace in $spbmvendor.VendorNamespaceInfo) {
                Foreach ($vendor in $namespace.vendorinfo) {
                    #$vendor.vendoruuid
                    $TempObjs = $spbmprofmgr.PbmFetchCapabilityMetadata($pbmprofileresourcetype, $vendor.VendorUuid)
                    Foreach ($TempObj in $TempObjs) {
                        $TempObj | Add-Member -MemberType NoteProperty -Name 'NameSpace' -Value $namespace.NamespaceInfo.Namespace
                        $results += $TempObj
                    }
                }
            }
        }
    }
    End { return $results }
}

Function Get-AVSStoragePolicy {
    <#
        .NOTES :
        --------------------------------------------------------
        Created by: K. Chris Nakagaki
            Organization : Microsoft
            COPYRIGHT (c) Microsoft. All rights reserved.
        --------------------------------------------------------
 
    .DESCRIPTION
        This function gets a list of all storage policy of specific type.
    .PARAMETER Name
        Name of Storage Policy
    .PARAMETER ResourceType
        Valid values are RESOURCE, DATA_SERVICE_POLICY, or REQUIREMENT
        Default is REQUIREMENT
#>

    [CmdletBinding()]
    param (
        [Parameter(Mandatory = $false)]
        [SupportsWildcards()]
        [string]
        $Name,
        [Parameter(Mandatory = $false)]
        [ValidateSet("RESOURCE", "DATA_SERVICE_POLICY", "REQUIREMENT")]
        [string]
        $ResourceType = "REQUIREMENT"
    )
    Begin {
        $serviceInstanceView = Get-SpbmView -Id "PbmServiceInstance-ServiceInstance"
        $spbmServiceContent = $serviceInstanceView.PbmRetrieveServiceContent()
        $spbmProfMgr = Get-SpbmView -Id $spbmServiceContent.ProfileManager

        $pbmprofileresourcetype = new-object vmware.spbm.views.PbmProfileResourceType
        $pbmprofileresourcetype.ResourceType = "STORAGE"

        $profiles = $spbmProfMgr.PbmQueryProfile($pbmprofileresourcetype, $ResourceType)
        if ([string]::IsNullOrEmpty($profiles)) {
            Write-Host "$ResourceType resourcetype produced no results"
            return
        }
        $registeredprofiles = $spbmProfMgr.PbmRetrieveContent($profiles)
    }
    Process {
        if ($Name) {
            if ([System.Management.Automation.WildcardPattern]::ContainsWildcardCharacters($Name)) {
                $registeredprofiles | Where-Object { $_.name -like $Name }
            }
            elseif (![System.Management.Automation.WildcardPattern]::ContainsWildcardCharacters($Name)) {
                $registeredprofiles | Where-Object { $_.name -eq $Name }
            }

        }
        else {
            $registeredprofiles
        }
    }
    End {
    }
}