PureStorage.CBS.AVS.VVOLS.ps1
|
function Mount-VvolDatastore { <# .SYNOPSIS Mounts a FlashArray VVol Datastore to a host or cluster .DESCRIPTION Mounts a FlashArray VVol Datastore to a cluster, connects a PE to the cluster if not present. The datastore will be created if it does not already exist. The function will return the exting (or newly created) datastore #> Param( [Parameter(Mandatory=$True)] $Flasharray, [Parameter(Mandatory=$True)] $vCenterServer, [Parameter(Mandatory=$false)] [string]$DatastoreName, [Parameter(Mandatory=$false)] [bool]$UseDefaultStore, [Parameter(Mandatory=$true,ValueFromPipeline=$True)] [VMware.VimAutomation.ViCore.Types.V1.Inventory.Cluster]$Cluster, [Parameter(Mandatory=$false)] [String]$AVSCloudName, [Parameter(Mandatory=$false)] [String]$AVSResourceGroup, [Parameter(Mandatory=$false)] [int]$TimeoutInMinutes = 10 ) if ($DatastoreName) { $datastore = Get-Datastore -Server $vCenterServer -Name $DatastoreName -ErrorAction Ignore if ($datastore) { throw "Cannot create the datastore. Datastore '$DatastoreName' already exists!" } } $arrayID = Get-ArrayID -FlashArray $Flasharray $arrayOui = Get-ArrayOUI -ArrayID $arrayID $ArrayName = Get-ArrayName -FlashArray $FlashArray if ($UseDefaultStore) { $scId = Get-RootStorageContainerID -ArrayID $arrayID $datastoreExists = Get-Datastore -Server $vCenterServer |Where-Object {$_.Type -eq "VVol"} |Where-Object {$_.ExtensionData.Info.VVolds.Scid -eq $scId} if (-not $datastoreExists) { if (-not $DatastoreName) { $DatastoreName = $ArrayName + "-vvol-DS" } } else { if (-not $DatastoreName) { $DatastoreName = $datastoreExists.Name } } } else { if (-not $DatastoreName) { throw "Datastore name must be provided when using non default containers." } # See if a pod was already created $pod = Get-Pfa2Pod -Array $Flasharray -Name $DatastoreName -ErrorAction Ignore if (-not $pod) { Write-Host "Creating a pod $DatastoreName ..." $pod = New-Pfa2Pod -Array $Flasharray -Name $DatastoreName -ErrorAction Stop } $pod_id = $pod.id.Replace("-","") $scid = "vvol:"+$pod_id.substring(0,16)+"-"+$pod_id.substring(16) } Write-Verbose "Using storage container ID '$scid'..." $datastoreExists = Get-Datastore |Where-Object {$_.Type -eq "VVol"} |Where-Object {$_.ExtensionData.Info.VVolds.Scid -eq $scId} if ($datastoreExists) { if ($DatastoreName -ne $datastoreExists.Name) { throw "A datastore '$($datastoreExists.Name)' already exists using container ID '$scid'. Will not be able to create a datastore with the name '$DatastoreName." } Write-Host "A datastore already exists. Using datastore $($datastoreExists.Name)..." $datastore = $datastoreExists } $esxiHosts = $cluster |Get-VMHost foreach ($esxi in $esxiHosts) { $hostPE = Find-ProtocolEndpoint -Esxi $esxi -DatastoreName $DatastoreName -UseDefaultStore $UseDefaultStore -arrayOui $arrayOui if (-not $hostPE) { if ($datastore) { $fa = Get-PfaConnectionOfDatastore -FlashArray $Flasharray -datastore $datastore -ErrorAction Ignore if ($null -eq $fa) { throw "No protocol endpoints found on the host $($esxi.name) for this array. Attempt to provision a PE failed as no valid PowerShell connections found for the array. Please either provision the protocol endpoint or connect the array to an existing PE." } } $hGroup = Get-PfaHostGroupfromVcCluster -cluster $cluster -flasharray $Flasharray -ErrorAction Stop $allPEs = Get-Pfa2Volume -Array $Flasharray | Where-Object {$_.Subtype -eq "protocol_endpoint"} -ErrorAction Stop if (($null -eq $protocolEndpoint) -or ($protocolEndpoint -eq "")) { $protocolEndpoint = "pure-protocol-endpoint" if (-not $UseDefaultStore) { $ProtocolEndpoint = "$DatastoreName::$ProtocolEndpoint" } } $pe = $allPEs | Where-Object {$_.name -eq $protocolEndpoint} if ($null -eq $pe) { $pe = New-Pfa2Volume -Array $Flasharray -Name $protocolEndpoint -Subtype "protocol_endpoint" } try { New-Pfa2Connection -Array $FlashArray -HostGroupNames $hGroup.name -VolumeNames $pe.name -ErrorAction Stop } catch { if ($_.Exception -notlike "*Connection already exists.*") { throw $_.Exception } } # Refresh VASA Providers $provider_id = (Get-VasaStorageArray -Server $vCenterServer -Id ("com.purestorage:" + (Get-Pfa2Array -Array $Flasharray).id)).provider.id Write-Host "Refreshing VASA Provider..." $out = Get-VasaProvider -Server $vCenterServer -id $provider_id -Refresh Write-Host "Refreshed VASA provider $($out.Name) ($($out.Id)" } } $params = @{ ClusterName = $Cluster.Name; DatastoreName = $DatastoreName; ScId = $SciD } Invoke-RunScript -RunCommandName "New-VvolDatastore" -RunCommandModule "Microsoft.AVS.VVOLS" -Parameters $params ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes $datastore = Get-Datastore -Server $vCenterServer -Name $DatastoreName -ErrorAction stop return $datastore } function Dismount-VvolDatastore { Param( [Parameter(Mandatory=$True)] $Flasharray, [Parameter(Mandatory=$True)] $vCenterServer, [Parameter(Mandatory=$True)] [string]$DatastoreName, [Parameter(Mandatory=$true,ValueFromPipeline=$True)] [VMware.VimAutomation.ViCore.Types.V1.Inventory.Cluster]$Cluster, [Parameter(Mandatory=$false)] [String]$AVSCloudName, [Parameter(Mandatory=$false)] [String]$AVSResourceGroup, [Parameter(Mandatory=$false)] [int]$TimeoutInMinutes = 10 ) $Datastore = Get-Datastore -Server $vCenterServer -Name $DatastoreName -ErrorAction Ignore if (-not $Datastore) { throw "Datastore ($DatastoreName) does not exist." } if ("VVOL" -ne $Datastore.Type) { throw "Datastore $DatastoreName is of type $($Datastore.Type). This cmdlet can only process VVol datastores" } $params = @{ ClusterName = $Cluster.Name; DatastoreName = $DatastoreName; } Write-Progress -Activity "Removing datastore" -Status "50% Complete:" -PercentComplete 50 Invoke-RunScript -RunCommandName "Remove-VvolDatastore" -RunCommandModule "Microsoft.AVS.VVOLS" -Parameters $params ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes } function Get-ArrayID { Param( [Parameter(Mandatory=$true)] $FlashArray ) $ArrayID = "com.purestorage:" + (Get-Pfa2Array -Array $Flasharray).id return $arrayID } function Get-ArrayName { Param( [Parameter(Mandatory=$true)] $FlashArray ) $ArrayName = (Get-Pfa2Array -Array $Flasharray).Name return $ArrayName } function Get-ArrayOUI { Param ( [Parameter(Mandatory=$true)] [string]$ArrayID ) $ArrayOui = $ArrayID.substring(16,36) $ArrayOui = $ArrayOui.replace("-","") $ArrayOui = $ArrayOui.Substring(0,16) return $ArrayOui } function Get-RootStorageContainerID { Param( [Parameter(Mandatory=$true)] [string]$ArrayID ) $md5 = new-object -TypeName System.Security.Cryptography.MD5CryptoServiceProvider $utf8 = new-object -TypeName System.Text.UTF8Encoding $hash = $md5.ComputeHash($utf8.GetBytes($ArrayID.substring(16,36))) $hash2 = $md5.ComputeHash(($hash)) $hash2[6] = $hash2[6] -band 0x0f $hash2[6] = $hash2[6] -bor 0x30 $hash2[8] = $hash2[8] -band 0x3f $hash2[8] = $hash2[8] -bor 0x80 $newGUID = (new-object -TypeName System.Guid -ArgumentList (,$hash2)).Guid $fixedGUID = $newGUID.Substring(18) $scId = $newGUID.Substring(6,2) + $newGUID.Substring(4,2) + $newGUID.Substring(2,2) + $newGUID.Substring(0,2) + "-" + $newGUID.Substring(11,2) + $newGUID.Substring(9,2) + "-" + $newGUID.Substring(16,2) + $newGUID.Substring(14,2) + $fixedGUID $scId = $scId.Replace("-","") $scId = "vvol:" + $scId.Insert(16,"-") return $scId } function Find-ProtocolEndpoint { Param ( $Esxi, $DatastoreName, $UseDefaultStore, $arrayOui ) $esxcli = $esxi |Get-EsxCli -v2 $hostProtocolEndpoint = $esxcli.storage.core.device.list.invoke() |where-object {$_.IsVVOLPE -eq $true} foreach ($hostPE in $hostProtocolEndpoint) { $peID = $hostPE.Device.Substring(12,24) $peID = $peID.Substring(0,16) if ($UseDefaultStore) { if ($peID -eq $arrayOui) { return $hostPE } } else { $PEVolumes = Get-Pfa2Volume -Array $Flasharray | Where-Object {($_.Pod.Name -eq $DatastoreName) -and ($_.Subtype -eq "protocol_endpoint")} foreach ($peVolume in $PEVolumes) { $volumeSerial = $peVolume.Serial.ToLower() if ($hostPe.Device -like "*$volumeSerial*"){ return $hostPE } } } } return $null } function Get-PfaConnectionOfDatastore { <# .SYNOPSIS Takes in a vVol or VMFS datastore, FlashArray connections and returns the correct connection. .DESCRIPTION Takes in a vVol or VMFS datastore, FlashArray connections and returns the correct connection or $null if not connected. #> Param( [Parameter(Mandatory=$True,ValueFromPipeline=$True)] $Flasharray, [Parameter(Mandatory=$true,ValueFromPipeline=$True)] [ValidateScript({ if (($_.Type -ne 'VMFS') -and ($_.Type -ne 'VVOL')) { throw "The entered datastore is not a VMFS or vVol datastore. It is type $($_.Type). Please only enter a VMFS or vVol datastore" } else { $true } })] [VMware.VimAutomation.ViCore.Types.V1.DatastoreManagement.Datastore]$Datastore ) if ($datastore.Type -eq 'VMFS') { $lun = $datastore.ExtensionData.Info.Vmfs.Extent.DiskName |select-object -unique if ($lun -like 'naa.624a9370*') { $volserial = ($lun.ToUpper()).substring(12) $pureVolumes = Get-Pfa2Volume -Array $Flasharray $purevol = $purevolumes | where-object { $_.serial -eq $volserial } if ($null -ne $purevol.name) { return $flasharray } } else { throw "This VMFS is not hosted on FlashArray storage." } } elseif ($datastore.Type -eq 'VVOL') { $datastoreArraySerial = $datastore.ExtensionData.Info.VvolDS.StorageArray[0].uuid.Substring(16) $arraySerial = (Get-Pfa2Array -Array $Flasharray).id if ($arraySerial -eq $datastoreArraySerial) { return $flasharray } } # The datastore was not found on any of the FlashArray connections. return $null } function Wait-VvolDatastoreCreation { Param( [Parameter(Mandatory=$true)] [string]$DatastoreName ) $retries = 0 # Datastore will not be available immediately. The retry logic keeps query the status of the datastore while ($retries -le 10) { $latestDatastore = (Get-Datastore | Where-Object {$_.Name -eq $DatastoreName}) if ("Available" -ne $latestDatastore.State) { $retries++ Start-Sleep -s 5 } else { Write-Host "The datastore '$($latestDatastore.Name)' is available" break } Write-Host "Waiting for the datastore '$($latestDatastore.Name)' to be available..." } if ("Available" -ne $latestDatastore.State) { throw "The datastore '$($datastore.Name)' is either not available or not acessible." } } function Update-VASAProviderCertificates { Param ( [Parameter(Mandatory=$true)] $ControllerName, [Parameter(Mandatory=$true)] $MgmtIP, [Parameter(Mandatory=$true)] $VASAProvider, [Parameter(Mandatory=$true)] [PScredential] $FlashArrayCredential, [Parameter(Mandatory=$false)] [String]$AVSCloudName, [Parameter(Mandatory=$false)] [String]$AVSResourceGroup, [Parameter(Mandatory=$false)] [int]$TimeoutInMinutes = 10 ) $ArrayName = Get-ArrayName -FlashArray $FlashArray $cert_name = "vasa-$ControllerName" Write-Host "Removing certificate $cert_name from FlashArray: $ArrayName ..." Remove-Pfa2Certificate -Array $Flasharray -Name $cert_name Write-Host "Creating self-signed certificate $cert_name on FlashArray: $ArrayName ..." New-Pfa2Certificate -Array $Flasharray -Name $cert_name -CommonName $MgmtIP.Eth.Address -Organization "Pure Storage" -OrganizationalUnit "Pure Storage" | Out-Null Write-Host "Removing VASA provider $provider_name ..." $param = @{ ProviderName = $VASAProvider.Name; } Invoke-RunScript -RunCommandName "Remove-VvolVasaProvider" -RunCommandModule "Microsoft.AVS.VVOLS" -Parameters $param ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes } function Get-VASAProviderFromControllerName { Param ( $FlashArray, $ControllerName ) $ArrayId = (Get-Pfa2Array -Array $FlashArray).Id $controller_num = $ControllerName.Substring(2) $ProviderId = "$ArrayId-$controller_num" $vasaProvider = Get-VasaProvider -Server $vCenterServer -ErrorAction Ignore | Where-Object {$_.ProviderId -eq $ProviderId} return $vasaProvider } function Update-VASAProvider { Param ( [Parameter(ValueFromPipeline=$True)] $FlashArray, [Parameter(Mandatory=$true)] $vCenterServer, [Parameter(Mandatory=$true)] [PScredential] $FlashArrayCredential, [Parameter(Mandatory=$false)] [String]$AVSCloudName, [Parameter(Mandatory=$false)] [String]$AVSResourceGroup, [Parameter(Mandatory=$false)] [Switch]$RefreshOnly, [Parameter(Mandatory=$false)] [int]$TimeoutInMinutes = 10 ) $MaxRetryCount = 10 $mgmtIPs = Get-Pfa2NetworkInterface -Array $Flasharray | Where-Object {$_.services -eq "management" -and $_.Enabled -and $_.Name -like "ct*"} $registeredController = @() $ArrayName = Get-ArrayName -FlashArray $FlashArray foreach ($mgmtIP in $mgmtIPs) { $vasaRegistered = $false $retry_count = 0 $controller_name = ($mgmtIp.Name.Split("."))[0] if ($registeredController -contains $controller_name) { continue } $provider_name = "$ArrayName-$controller_name" do { $vasaProvider = Get-VASAProviderFromControllerName -FlashArray $FlashArray -ControllerName $controller_name if ($vasaProvider) { Write-Host "VASA Provider already exists for ‘$ArrayName’ controller ‘$controller_name’..." if ($RefreshOnly) { Update-VASAProviderCertificates -VASAProvider $vasaProvider -ControllerName $controller_name -mgmtIP $mgmtIP -FlashArrayCredential $FlashArrayCredential ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes $vasaRegistered = $False } elseif ($vasaProvider.status -eq "online") { $vasaRegistered = $True } elseif ($vasaProvider.status -eq "offline") { # VASA provider can be offline if: # - Array is not accessible (in this case, we will get an error when trying to connect) # - Certificate is expired # - Certificate is invalid (for example a new certificate uploaded to the Array) Write-Warning "VASA provider $provider_name status is $($vasaProvider.status)" # No need to check for expiry time as the cert might not be expired but invalid. Remove the certificate and re-register the VASA provider Update-VASAProviderCertificates -VASAProvider $vasaProvider -ControllerName $controller_name -mgmtIP $mgmtIP -FlashArrayCredential $FlashArrayCredential ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes $vasaRegistered = $False } else { throw "Could not update VASA provider. VASA provider $provider_name status is $($vasaProvider.status)." } } else { Write-Host "Creating VASA Provider for CBS '$ArrayName' controller '$controller_name'..." try { $param = @{ ProviderName = $provider_name; ProviderCredential = $FlashArrayCredential; ProviderUrl = "https://$($mgmtIP.Eth.Address):8084"; } Invoke-RunScript -RunCommandName "New-VvolVasaProvider" -RunCommandModule "Microsoft.AVS.VVOLS" -Parameters $param ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes $vasaRegistered = $True Write-Host "VASA Provider for $provider_name created successfully." } catch { if ($retry_count -lt $MaxRetryCount) { Write-Warning "Failed to register VASA provider $provider_name with error $_ Retrying ..." $vasaRegistered = $false Start-Sleep -Seconds 10 } else { throw "Failed to register VASA provider $provider_name with error $_" } } } $retry_count = $retry_count + 1 } while ($vasaRegistered -ne $true -and $retry_count -lt $MaxRetryCount) if (-not $vasaRegistered) { throw "Failed to register VASA provider $provider_name after $retry_count tries." } else { $registeredController += $controller_name } } $param = @{} Invoke-RunScript -RunCommandName "Update-VMHostCertificate" -RunCommandModule "Microsoft.AVS.VVOLS" -Parameters $param ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes } function New-VvolStoragePolicy { Param( [Parameter(Mandatory = $true)] [String]$PolicyName, [Parameter(Mandatory = $false)] [String]$PolicyDescription, [Parameter(Mandatory = $false)] [string[]]$SourcePureCloudBlockStores, [Parameter(Mandatory = $false)] [Nullable[boolean]]$ReplicationEnabled, [Parameter(Mandatory = $false)] [Nullable[Timespan]]$ReplicationInterval, [Parameter(Mandatory = $false)] [Nullable[Timespan]]$ReplicationRetentionInterval, [Parameter(Mandatory = $false)] [Nullable[boolean]]$ReplicationRuleLocalSnapshotEnabled, [Parameter(Mandatory = $false)] [Nullable[Timespan]]$ReplicationRuleLocalSnapshotInterval, [Parameter(Mandatory = $false)] [Nullable[Timespan]]$ReplicationRuleLocalSnapshotRetentionInterval, [Parameter(Mandatory = $false)] [int]$ReplicationConcurrency, [Parameter(Mandatory=$false)] [Nullable[boolean]]$ReplicationRansomwareProtection, [Parameter(Mandatory = $false)] [string[]]$TargetPureCloudBlockStores, [Parameter(Mandatory = $false)] [String]$ConsistencyGroupName, [Parameter(Mandatory = $false)] [int]$PerVirtualDiskIOPSLimit, [Parameter(Mandatory = $false)] [String]$PerVirtualDiskIOPSLimitUnit, [Parameter(Mandatory = $false)] [int]$PerVirtualDiskBandwidthLimit, [Parameter(Mandatory = $false)] [String]$PerVirtualDiskBandwidthLimitUnit, [Parameter(Mandatory = $false)] [String]$VolumeTaggingKey, [Parameter(Mandatory = $false)] [String]$VolumeTaggingValue, [Parameter(Mandatory = $false)] [Nullable[boolean]]$VolumeTaggingCopyable, [Parameter(Mandatory = $false)] [Nullable[Timespan]]$PlacementRuleLocalSnapshotInterval, [Parameter(Mandatory = $false)] [Nullable[Timespan]]$PlacementRuleLocalSnapshotRetentionInterval, [Parameter(Mandatory = $false)] [int]$PlacementRuleLocalSnapshotRetainAdditionalSnapshots, [Parameter(Mandatory = $false)] [int]$PlacementRuleLocalSnapshotRetainAdditionalDays, [Parameter(Mandatory=$false)] [string]$OffloadType, [Parameter(Mandatory=$false)] [string[]]$OffloadTargetNames, [Parameter(Mandatory=$false)] [Nullable[Timespan]]$OffloadReplicationInterval, [Parameter(Mandatory=$false)] [string]$OffloadOffloadReplicationTime, [Parameter(Mandatory=$false)] [Nullable[Timespan]]$OffloadRetentionInterval, [Parameter(Mandatory=$false)] [int]$OffloadRetainAdditionalSnapshots, [Parameter(Mandatory=$false)] [int]$OffloadRetainAdditionalDays, [Parameter(Mandatory=$false)] [string]$OffloadReplicationBlackoutFrom, [Parameter(Mandatory=$false)] [string]$OffloadReplicationBlackoutTo, [Parameter(Mandatory=$false)] [Nullable[boolean]]$DefaultProtectionOptout, [Parameter(Mandatory = $false)] [String]$AVSCloudName, [Parameter(Mandatory = $false)] [String]$AVSResourceGroup, [Parameter(Mandatory = $true)] [String]$vCenterServer, [Parameter(Mandatory=$false)] [int]$TimeoutInMinutes = 10 ) $StroagePolicy = Get-SpbmStoragePolicy -Server $vCenterServer -Name $PolicyName -ErrorAction Ignore if ($StroagePolicy) { throw "A storage policy with the name of $PolicyName already exists`n `n Please choose a unique name." } $PureCapability = Get-SpbmCapability -Server $vCenterServer | Where-Object { $_.name -like "com.purestorage*" } if (-not $PureCapability) { throw "This vCenter does not have any Pure VASA providers registered and therefore no policy can be created. ..." } Write-Host "Creating policy $PolicyName..." $policyConfig = [FlashArrayvVolPolicyConfig]::new($policyName, $policyDescription, $SourcePureCloudBlockStores, $ReplicationEnabled, $replicationInterval, $replicationRetentionInterval, $replicationConcurrency, $consistencyGroupName, $TargetPureCloudBlockStores, $ReplicationRuleLocalSnapshotEnabled, $ReplicationRuleLocalSnapshotInterval, $ReplicationRuleLocalSnapshotRetentionInterval, $ReplicationRansomwareProtection, $PerVirtualDiskIOPSLimit, $PerVirtualDiskIOPSLimitUnit, $PerVirtualDiskBandwidthLimit, $PerVirtualDiskBandwidthLimitUnit, $VolumeTaggingKey, $VolumeTaggingValue, $VolumeTaggingCopyable, $PlacementRuleLocalSnapshotInterval, $PlacementRuleLocalSnapshotRetentionInterval, $PlacementRuleLocalSnapshotRetainAdditionalSnapshots, $PlacementRuleLocalSnapshotRetainAdditionalDays, $OffloadType, $OffloadTargetNames, $OffloadReplicationInterval, $OffloadOffloadReplicationTime, $OffloadRetentionInterval, $OffloadRetainAdditionalSnapshots, $OffloadRetainAdditionalDays, $OffloadReplicationBlackoutFrom, $OffloadReplicationBlackoutTo, $DefaultProtectionOptout ) $PolicyConfigJsonString = $policyConfig.ToJsonString() Write-Debug "PolicyConfigJsonString: $PolicyConfigJsonString" Invoke-RunScript -RunCommandName "New-VvolStoragePolicy" -RunCommandModule "Microsoft.AVS.VVOLS" ` -Parameters @{PolicyConfigJsonString = $PolicyConfigJsonString } ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes } function Remove-VvolStoragePolicy { Param( [Parameter(mandatory = $true)] [string]$PolicyName, [Parameter(Mandatory = $false)] [String]$AVSCloudName, [Parameter(Mandatory = $false)] [String]$AVSResourceGroup, [Parameter(Mandatory = $true)] [String]$vCenterServer, [Parameter(Mandatory=$false)] [int]$TimeoutInMinutes = 10 ) $StroagePolicy = Get-SpbmStoragePolicy -Server $vCenterServer | Where-Object { $_.Name -eq $PolicyName } if (-not $StroagePolicy) { throw "No existing policy is found with policy name $PolicyName." } $PureCapability = $StroagePolicy.AnyOfRuleSets.AllOfRules.Capability | where-object { $_.Name -like "com.purestorage*" } if ($PureCapability.Count -eq 0) { throw "The policy $PolicyName is not managed by Pure Storage." } Invoke-RunScript -RunCommandName "Remove-VvolStoragePolicy" -RunCommandModule "Microsoft.AVS.VVOLS" ` -Parameters @{ PolicyName = $PolicyName } ` -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes } #Custom Classes Class FlashArrayvVolPolicyConfig { [String] $version = "1.0.0" [String] $vendor = "Pure Storage" [System.Boolean]$flasharray = $true [String]$policyName = "" [String]$policyDescription = "Pure Storage Cloud Block Store vVol storage policy default description" $SpbmRules = @{ } FlashArrayvVolPolicyConfig ([String]$policyName, [String]$policyDescription, [String[]]$sourceFlashArrays, [Nullable[boolean]]$replicationEnabled, [Nullable[System.TimeSpan]]$replicationInterval, [Nullable[System.TimeSpan]]$ReplicationRetentionInterval, [int]$replicationConcurrency, [String]$consistencyGroupName, [String[]]$targetFlashArrays, [Nullable[boolean]]$ReplicationRuleLocalSnapshotEnabled, [Nullable[System.TimeSpan]]$ReplicationRuleLocalSnapshotInterval, [Nullable[System.TimeSpan]]$ReplicationRuleLocalSnapshotRetentionInterval, [Nullable[boolean]]$ReplicationRansomwareProtection, [int]$PerVirtualDiskIOPSLimit, [String]$PerVirtualDiskIOPSLimitUnit, [int]$PerVirtualDiskBandwidthLimit, [String]$PerVirtualDiskBandwidthLimitUnit, [String]$VolumeTaggingKey, [String]$VolumeTaggingValue, [Nullable[boolean]]$VolumeTaggingCopyable, [Nullable[System.TimeSpan]]$PlacementRuleLocalSnapshotInterval, [Nullable[System.TimeSpan]]$PlacementRuleLocalSnapshotRetentionInterval, [int]$PlacementRuleLocalSnapshotRetainAdditionalSnapshots, [int]$PlacementRuleLocalSnapshotRetainAdditionalDays, [string]$OffloadType, [string[]]$OffloadTargetNames, [Nullable[Timespan]]$OffloadReplicationInterval, [string]$OffloadOffloadReplicationTime, [Nullable[Timespan]]$OffloadRetentionInterval, [int]$OffloadRetainAdditionalSnapshots, [int]$OffloadRetainAdditionalDays, [string]$OffloadReplicationBlackoutFrom, [string]$OffloadReplicationBlackoutTo, [Nullable[boolean]]$DefaultProtectionOptout) { $this.policyName = $policyName $this.policyDescription = $policyDescription if ($replicationEnabled -eq $false) { if ([System.TimeSpan]0 -ne $replicationInterval -and $null -ne $replicationInterval) { throw "Do not specify a replication interval if replicationEnabled is set to false." } if ([System.TimeSpan]0 -ne $ReplicationRetentionInterval -and $null -ne $ReplicationRetentionInterval) { throw "Do not specify a replication retention if replicationEnabled is set to false." } } if ($ReplicationRuleLocalSnapshotEnabled -eq $false) { if ([System.TimeSpan]0 -ne $ReplicationRuleLocalSnapshotInterval -and $null -ne $ReplicationRuleLocalSnapshotInterval) { throw "Do not specify a snapshot interval if ReplicationRuleLocalSnapshotEnabled is set to false." } if ([System.TimeSpan]0 -ne $ReplicationRuleLocalSnapshotRetentionInterval -and $null -ne $ReplicationRuleLocalSnapshotRetentionInterval) { throw "Do not specify a snapshot retention if ReplicationRuleLocalSnapshotEnabled is set to false." } } if ($null -eq $OffloadRetentionInterval) { if ($OffloadRetainAdditionalSnapshots -gt 0 -or $OffloadRetainAdditionalDays -gt 0) { throw "Do not specify additional retention options if Offload retention interval is not set." } } if ($sourceFlashArrays.count -ne 0) { $this.SpbmRules["com.purestorage.storage.policy.FlashArrayGroup"] = $sourceFlashArrays } $this.SpbmRules["com.purestorage.storage.policy.PureFlashArray"] = $true # Replication if ($null -ne $ReplicationRuleLocalSnapshotEnabled) { $this.SpbmRules["com.purestorage.storage.replication.LocalSnapshotPolicyCapable"] = $ReplicationRuleLocalSnapshotEnabled } if ($null -ne $ReplicationRuleLocalSnapshotInterval) { $this.SpbmRules["com.purestorage.storage.replication.LocalSnapshotInterval"] = $ReplicationRuleLocalSnapshotInterval.ToString() } if ($null -ne $ReplicationRuleLocalSnapshotRetentionInterval) { $this.SpbmRules["com.purestorage.storage.replication.LocalSnapshotRetention"] = $ReplicationRuleLocalSnapshotRetentionInterval.ToString() } if ($targetFlashArrays.count -ne 0) { $this.SpbmRules["com.purestorage.storage.replication.ReplicationTarget"] = $targetFlashArrays } if ($null -ne $replicationEnabled) { $this.SpbmRules["com.purestorage.storage.replication.RemoteReplicationCapable"] = $replicationEnabled } if ($null -ne $replicationInterval) { $this.SpbmRules["com.purestorage.storage.replication.RemoteReplicationInterval"] = $replicationInterval.ToString() } if ($null -ne $replicationRetentionInterval) { $this.SpbmRules["com.purestorage.storage.replication.RemoteReplicationRetention"] = $replicationRetentionInterval.ToString() } if (!([string]::IsNullOrWhiteSpace($consistencyGroupName))) { $this.SpbmRules["com.purestorage.storage.replication.ReplicationConsistencyGroup"] = $consistencyGroupName } if (($null -ne $replicationConcurrency) -and ($replicationConcurrency -ne 0)) { $this.SpbmRules["com.purestorage.storage.replication.replicationConcurrency"] = $replicationConcurrency } if ($null -ne $ReplicationRansomwareProtection) { $this.SpbmRules["com.purestorage.storage.replication.RansomwareProtection"] = $ReplicationRansomwareProtection } # IOPS Limit if (($null -ne $PerVirtualDiskIOPSLimit) -and ($PerVirtualDiskIOPSLimit -ne 0)) { $this.SpbmRules["com.purestorage.storage.policy.IopsLimit.IopsLimit"] = $PerVirtualDiskIOPSLimit } if (!([string]::IsNullOrWhiteSpace($PerVirtualDiskIOPSLimitUnit))) { $this.SpbmRules["com.purestorage.storage.policy.IopsLimit.IopsLimitUnit"] = $PerVirtualDiskIOPSLimitUnit } # Bandwidth Limit if (($null -ne $PerVirtualDiskBandwidthLimit) -and ($PerVirtualDiskBandwidthLimit -ne 0)) { $this.SpbmRules["com.purestorage.storage.policy.BandwidthLimit.BandwidthLimit"] = $PerVirtualDiskBandwidthLimit } if (!([string]::IsNullOrWhiteSpace($PerVirtualDiskBandwidthLimitUnit))) { $this.SpbmRules["com.purestorage.storage.policy.BandwidthLimit.BandwidthLimitUnit"] = $PerVirtualDiskBandwidthLimitUnit } # Volume Tag if (!([string]::IsNullOrWhiteSpace($VolumeTaggingKey))) { $this.SpbmRules["com.purestorage.storage.policy.VolumeTagging.TagKey"] = $VolumeTaggingKey } if (!([string]::IsNullOrWhiteSpace($VolumeTaggingValue))) { $this.SpbmRules["com.purestorage.storage.policy.VolumeTagging.TagValue"] = $VolumeTaggingValue } if ($null -ne $VolumeTaggingCopyable) { $this.SpbmRules["com.purestorage.storage.policy.VolumeTagging.TagCopyable"] = $VolumeTaggingCopyable } # Local snapshot if ($null -ne $PlacementRuleLocalSnapshotInterval) { $this.SpbmRules["com.purestorage.storage.policy.LocalSnapshotProtection.LocalSnapshotInterval"] = $PlacementRuleLocalSnapshotInterval.ToString() } if ($null -ne $PlacementRuleLocalSnapshotRetentionInterval) { $this.SpbmRules["com.purestorage.storage.policy.LocalSnapshotProtection.LocalSnapshotRetention"] = $PlacementRuleLocalSnapshotRetentionInterval.ToString() } if (($null -ne $PlacementRuleLocalSnapshotRetainAdditionalSnapshots) -and ($PlacementRuleLocalSnapshotRetainAdditionalSnapshots -ne 0)) { $this.SpbmRules["com.purestorage.storage.policy.LocalSnapshotProtection.LocalSnapshotThenRetain"] = $PlacementRuleLocalSnapshotRetainAdditionalSnapshots } if (($null -ne $PlacementRuleLocalSnapshotRetainAdditionalDays) -and ($PlacementRuleLocalSnapshotRetainAdditionalDays -ne 0)) { $this.SpbmRules["com.purestorage.storage.policy.LocalSnapshotProtection.LocalSnapshotForAdditionalDays"] = $PlacementRuleLocalSnapshotRetainAdditionalDays } # Offload if (!([string]::IsNullOrWhiteSpace($OffloadType))) { $this.SpbmRules["com.purestorage.storage.policy.Offload.OffloadTargetProtocol"] = $OffloadType } if ($null -ne $OffloadTargetNames) { $this.SpbmRules["com.purestorage.storage.policy.Offload.OffloadTargetNames"] = $OffloadTargetNames } if ($null -ne $OffloadReplicationInterval) { $this.SpbmRules["com.purestorage.storage.policy.Offload.OffloadReplicationInterval"] = $OffloadReplicationInterval.ToString() } if (!([string]::IsNullOrWhiteSpace($OffloadOffloadReplicationTime))) { $this.SpbmRules["com.purestorage.storage.policy.Offload.OffloadReplicationTime"] = $OffloadOffloadReplicationTime } if ($null -ne $OffloadRetentionInterval) { $this.SpbmRules["com.purestorage.storage.policy.Offload.OffloadRetentionInterval"] = $OffloadRetentionInterval.ToString() } if (($null -ne $OffloadRetainAdditionalSnapshots) -and ($OffloadRetainAdditionalSnapshots -ne 0)) { $this.SpbmRules["com.purestorage.storage.policy.Offload.OffloadRetentionExtraSnapshotsPerDay"] = $OffloadRetainAdditionalSnapshots } if (($null -ne $OffloadRetainAdditionalDays) -and ($OffloadRetainAdditionalDays -ne 0)) { $this.SpbmRules["com.purestorage.storage.policy.Offload.OffloadRetentionExtraSnapshotsDays"] = $OffloadRetainAdditionalDays } if (!([string]::IsNullOrWhiteSpace($OffloadReplicationBlackoutFrom))) { $this.SpbmRules["com.purestorage.storage.policy.Offload.OffloadReplicationBlackoutFrom"] = $OffloadReplicationBlackoutFrom } if (!([string]::IsNullOrWhiteSpace($OffloadReplicationBlackoutTo))) { $this.SpbmRules["com.purestorage.storage.policy.Offload.OffloadReplicationBlackoutTo"] = $OffloadReplicationBlackoutTo } # Default Protection if ($DefaultProtectionOptout) { $this.SpbmRules["com.purestorage.storage.policy.DefaultProtection"] = "Opt out" } } [string] ToJsonString() { return $this | ConvertTo-Json } } # SIG # Begin signature block # MIIuggYJKoZIhvcNAQcCoIIuczCCLm8CAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCC7OyeSgzR5x1J5 # jvV+HnX6mZDjF9oE/fjSbkSv+yR+LaCCE2gwggVyMIIDWqADAgECAhB2U/6sdUZI # k/Xl10pIOk74MA0GCSqGSIb3DQEBDAUAMFMxCzAJBgNVBAYTAkJFMRkwFwYDVQQK # ExBHbG9iYWxTaWduIG52LXNhMSkwJwYDVQQDEyBHbG9iYWxTaWduIENvZGUgU2ln # bmluZyBSb290IFI0NTAeFw0yMDAzMTgwMDAwMDBaFw00NTAzMTgwMDAwMDBaMFMx # CzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMSkwJwYDVQQD # EyBHbG9iYWxTaWduIENvZGUgU2lnbmluZyBSb290IFI0NTCCAiIwDQYJKoZIhvcN # AQEBBQADggIPADCCAgoCggIBALYtxTDdeuirkD0DcrA6S5kWYbLl/6VnHTcc5X7s # k4OqhPWjQ5uYRYq4Y1ddmwCIBCXp+GiSS4LYS8lKA/Oof2qPimEnvaFE0P31PyLC # o0+RjbMFsiiCkV37WYgFC5cGwpj4LKczJO5QOkHM8KCwex1N0qhYOJbp3/kbkbuL # ECzSx0Mdogl0oYCve+YzCgxZa4689Ktal3t/rlX7hPCA/oRM1+K6vcR1oW+9YRB0 # RLKYB+J0q/9o3GwmPukf5eAEh60w0wyNA3xVuBZwXCR4ICXrZ2eIq7pONJhrcBHe # OMrUvqHAnOHfHgIB2DvhZ0OEts/8dLcvhKO/ugk3PWdssUVcGWGrQYP1rB3rdw1G # R3POv72Vle2dK4gQ/vpY6KdX4bPPqFrpByWbEsSegHI9k9yMlN87ROYmgPzSwwPw # jAzSRdYu54+YnuYE7kJuZ35CFnFi5wT5YMZkobacgSFOK8ZtaJSGxpl0c2cxepHy # 1Ix5bnymu35Gb03FhRIrz5oiRAiohTfOB2FXBhcSJMDEMXOhmDVXR34QOkXZLaRR # kJipoAc3xGUaqhxrFnf3p5fsPxkwmW8x++pAsufSxPrJ0PBQdnRZ+o1tFzK++Ol+ # A/Tnh3Wa1EqRLIUDEwIrQoDyiWo2z8hMoM6e+MuNrRan097VmxinxpI68YJj8S4O # JGTfAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB0G # A1UdDgQWBBQfAL9GgAr8eDm3pbRD2VZQu86WOzANBgkqhkiG9w0BAQwFAAOCAgEA # Xiu6dJc0RF92SChAhJPuAW7pobPWgCXme+S8CZE9D/x2rdfUMCC7j2DQkdYc8pzv # eBorlDICwSSWUlIC0PPR/PKbOW6Z4R+OQ0F9mh5byV2ahPwm5ofzdHImraQb2T07 # alKgPAkeLx57szO0Rcf3rLGvk2Ctdq64shV464Nq6//bRqsk5e4C+pAfWcAvXda3 # XaRcELdyU/hBTsz6eBolSsr+hWJDYcO0N6qB0vTWOg+9jVl+MEfeK2vnIVAzX9Rn # m9S4Z588J5kD/4VDjnMSyiDN6GHVsWbcF9Y5bQ/bzyM3oYKJThxrP9agzaoHnT5C # JqrXDO76R78aUn7RdYHTyYpiF21PiKAhoCY+r23ZYjAf6Zgorm6N1Y5McmaTgI0q # 41XHYGeQQlZcIlEPs9xOOe5N3dkdeBBUO27Ql28DtR6yI3PGErKaZND8lYUkqP/f # obDckUCu3wkzq7ndkrfxzJF0O2nrZ5cbkL/nx6BvcbtXv7ePWu16QGoWzYCELS/h # AtQklEOzFfwMKxv9cW/8y7x1Fzpeg9LJsy8b1ZyNf1T+fn7kVqOHp53hWVKUQY9t # W76GlZr/GnbdQNJRSnC0HzNjI3c/7CceWeQIh+00gkoPP/6gHcH1Z3NFhnj0qinp # J4fGGdvGExTDOUmHTaCX4GUT9Z13Vunas1jHOvLAzYIwggbmMIIEzqADAgECAhB3 # vQ4DobcI+FSrBnIQ2QRHMA0GCSqGSIb3DQEBCwUAMFMxCzAJBgNVBAYTAkJFMRkw # FwYDVQQKExBHbG9iYWxTaWduIG52LXNhMSkwJwYDVQQDEyBHbG9iYWxTaWduIENv # ZGUgU2lnbmluZyBSb290IFI0NTAeFw0yMDA3MjgwMDAwMDBaFw0zMDA3MjgwMDAw # MDBaMFkxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMS8w # LQYDVQQDEyZHbG9iYWxTaWduIEdDQyBSNDUgQ29kZVNpZ25pbmcgQ0EgMjAyMDCC # AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANZCTfnjT8Yj9GwdgaYw90g9 # z9DljeUgIpYHRDVdBs8PHXBg5iZU+lMjYAKoXwIC947Jbj2peAW9jvVPGSSZfM8R # Fpsfe2vSo3toZXer2LEsP9NyBjJcW6xQZywlTVYGNvzBYkx9fYYWlZpdVLpQ0LB/ # okQZ6dZubD4Twp8R1F80W1FoMWMK+FvQ3rpZXzGviWg4QD4I6FNnTmO2IY7v3Y2F # QVWeHLw33JWgxHGnHxulSW4KIFl+iaNYFZcAJWnf3sJqUGVOU/troZ8YHooOX1Re # veBbz/IMBNLeCKEQJvey83ouwo6WwT/Opdr0WSiMN2WhMZYLjqR2dxVJhGaCJedD # CndSsZlRQv+hst2c0twY2cGGqUAdQZdihryo/6LHYxcG/WZ6NpQBIIl4H5D0e6lS # TmpPVAYqgK+ex1BC+mUK4wH0sW6sDqjjgRmoOMieAyiGpHSnR5V+cloqexVqHMRp # 5rC+QBmZy9J9VU4inBDgoVvDsy56i8Te8UsfjCh5MEV/bBO2PSz/LUqKKuwoDy3K # 1JyYikptWjYsL9+6y+JBSgh3GIitNWGUEvOkcuvuNp6nUSeRPPeiGsz8h+WX4VGH # aekizIPAtw9FbAfhQ0/UjErOz2OxtaQQevkNDCiwazT+IWgnb+z4+iaEW3VCzYkm # eVmda6tjcWKQJQ0IIPH/AgMBAAGjggGuMIIBqjAOBgNVHQ8BAf8EBAMCAYYwEwYD # VR0lBAwwCgYIKwYBBQUHAwMwEgYDVR0TAQH/BAgwBgEB/wIBADAdBgNVHQ4EFgQU # 2rONwCSQo2t30wygWd0hZ2R2C3gwHwYDVR0jBBgwFoAUHwC/RoAK/Hg5t6W0Q9lW # ULvOljswgZMGCCsGAQUFBwEBBIGGMIGDMDkGCCsGAQUFBzABhi1odHRwOi8vb2Nz # cC5nbG9iYWxzaWduLmNvbS9jb2Rlc2lnbmluZ3Jvb3RyNDUwRgYIKwYBBQUHMAKG # Omh0dHA6Ly9zZWN1cmUuZ2xvYmFsc2lnbi5jb20vY2FjZXJ0L2NvZGVzaWduaW5n # cm9vdHI0NS5jcnQwQQYDVR0fBDowODA2oDSgMoYwaHR0cDovL2NybC5nbG9iYWxz # aWduLmNvbS9jb2Rlc2lnbmluZ3Jvb3RyNDUuY3JsMFYGA1UdIARPME0wQQYJKwYB # BAGgMgEyMDQwMgYIKwYBBQUHAgEWJmh0dHBzOi8vd3d3Lmdsb2JhbHNpZ24uY29t # L3JlcG9zaXRvcnkvMAgGBmeBDAEEATANBgkqhkiG9w0BAQsFAAOCAgEACIhyJsav # +qxfBsCqjJDa0LLAopf/bhMyFlT9PvQwEZ+PmPmbUt3yohbu2XiVppp8YbgEtfjr # y/RhETP2ZSW3EUKL2Glux/+VtIFDqX6uv4LWTcwRo4NxahBeGQWn52x/VvSoXMNO # Ca1Za7j5fqUuuPzeDsKg+7AE1BMbxyepuaotMTvPRkyd60zsvC6c8YejfzhpX0FA # Z/ZTfepB7449+6nUEThG3zzr9s0ivRPN8OHm5TOgvjzkeNUbzCDyMHOwIhz2hNab # XAAC4ShSS/8SS0Dq7rAaBgaehObn8NuERvtz2StCtslXNMcWwKbrIbmqDvf+28rr # vBfLuGfr4z5P26mUhmRVyQkKwNkEcUoRS1pkw7x4eK1MRyZlB5nVzTZgoTNTs/Z7 # KtWJQDxxpav4mVn945uSS90FvQsMeAYrz1PYvRKaWyeGhT+RvuB4gHNU36cdZytq # tq5NiYAkCFJwUPMB/0SuL5rg4UkI4eFb1zjRngqKnZQnm8qjudviNmrjb7lYYuA2 # eDYB+sGniXomU6Ncu9Ky64rLYwgv/h7zViniNZvY/+mlvW1LWSyJLC9Su7UpkNpD # R7xy3bzZv4DB3LCrtEsdWDY3ZOub4YUXmimi/eYI0pL/oPh84emn0TCOXyZQK8ei # 4pd3iu/YTT4m65lAYPM8Zwy2CHIpNVOBNNwwggcEMIIE7KADAgECAgxcuW61kTkv # +4t8zgQwDQYJKoZIhvcNAQELBQAwWTELMAkGA1UEBhMCQkUxGTAXBgNVBAoTEEds # b2JhbFNpZ24gbnYtc2ExLzAtBgNVBAMTJkdsb2JhbFNpZ24gR0NDIFI0NSBDb2Rl # U2lnbmluZyBDQSAyMDIwMB4XDTI0MDMxMTE0MDQxMloXDTI3MDMxMjE0MDQxMlow # cjELMAkGA1UEBhMCVVMxEzARBgNVBAgTCkNhbGlmb3JuaWExFDASBgNVBAcTC1Nh # bnRhIENsYXJhMRswGQYDVQQKExJQdXJlIFN0b3JhZ2UsIEluYy4xGzAZBgNVBAMT # ElB1cmUgU3RvcmFnZSwgSW5jLjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoC # ggIBAMCQrioSn48IvHpTg5dofsUYj/pNTDidwjYUrcxVu78NoyhSweG8FhcxDi/S # I40+8Fccl3D5ZoqpjkFnGhzSwmpxU3J4AP7+fdTZht9eWD1I5qKY07esYwdPDV4y # g+csPfdGPqI2XjRfT5UC3YkXQeUrX8KQZldD4KqvgxzpYcuBwsgHbTb/eArpi68Y # gFR2jgZGyZigfy8RuJMrL1thcBOe/VWjUyK21wVT8cuunBYFaStLHhsRBRMDcZBD # uTSGC4evE6oaCqlQbdMl9YFJ64mDQsKlCxrr7rmLVtcVzKGwmjp4b2xRwE+RmTh6 # JtrUL9Wx/3a3UzgAnDNimfwp85zoL48kyLtHqQ3FI8tVKGm+aBOgBZfmURoy7fbp # 4zKhGgqFbpOmILO16i4f999YsEEJQgIF3CtyH1R60/ZZWlDmoeeEgjAGrnd14muU # 5Hk3Cksr43uPUAg+fV78Y0fDV85ibm42ZwwPuz6MI4HhYNUlGzRwIQ31vjaGuAMW # HNqFKkcO0JuIeHQ/gFKPnYIxnGC9H9R4Kw/uMezqtnYJwGU2epB/ABl/w7U4NgU2 # ZOxWB5BFy4frZ3f+hNgbjFUjMaXnVFotOJxXntzjdSl4znw8DaKiC5ooChteZMIT # G9p078p/TUsOJQbUtFADSY1hsfCfB7t+gJSNt5peS9GOZIMVAgMBAAGjggGxMIIB # rTAOBgNVHQ8BAf8EBAMCB4AwgZsGCCsGAQUFBwEBBIGOMIGLMEoGCCsGAQUFBzAC # hj5odHRwOi8vc2VjdXJlLmdsb2JhbHNpZ24uY29tL2NhY2VydC9nc2djY3I0NWNv # ZGVzaWduY2EyMDIwLmNydDA9BggrBgEFBQcwAYYxaHR0cDovL29jc3AuZ2xvYmFs # c2lnbi5jb20vZ3NnY2NyNDVjb2Rlc2lnbmNhMjAyMDBWBgNVHSAETzBNMEEGCSsG # AQQBoDIBMjA0MDIGCCsGAQUFBwIBFiZodHRwczovL3d3dy5nbG9iYWxzaWduLmNv # bS9yZXBvc2l0b3J5LzAIBgZngQwBBAEwCQYDVR0TBAIwADBFBgNVHR8EPjA8MDqg # OKA2hjRodHRwOi8vY3JsLmdsb2JhbHNpZ24uY29tL2dzZ2NjcjQ1Y29kZXNpZ25j # YTIwMjAuY3JsMBMGA1UdJQQMMAoGCCsGAQUFBwMDMB8GA1UdIwQYMBaAFNqzjcAk # kKNrd9MMoFndIWdkdgt4MB0GA1UdDgQWBBSzJ9KiDCa3UBiAajy+Iioj5kQjzDAN # BgkqhkiG9w0BAQsFAAOCAgEAHsFQixeQEcoHurq9NWSUt4S39Q+UGP6crmVq3Wwy # 9g23YbdWg+SgMxoLUqdoDfA4k4B6Dyoo0jEQzn2kxnsnT9lNHKrcZHH88dv0hjfi # H2qAiQWazPjS3LhK2J6nhpyipJPpyRaSQG4x4aG0NB2D4WUfUz9CGAYsERJGww/w # kTaaxMipttKDTaI1C49u1igDfRzIO+Q8vuyyBFLiYTno/df97xtjNC+KxxFhDhl/ # 4tawK6kwxaVzCMAfj48I67Wbo4DMH6pM1s19as7c3qp92i3MylGKsB6+u+o7UkbS # dLNkS4ALI33CJOUc+GoK3Nt5IXXCFJTQFHBXkBdAur3gmlXEm8vlNG/1Sbxr0H7T # 1e7ABGH/48o/+PeMLuCc72EeK5dJ4cX9NEQ3QnTsZHwGnYzjEOvOvP0s1c7yNsDb # cUHoIqQvb5xS5aqMU5G+8sdPQ1nwpPf7gGaEEbAVW4w51Pam42qeN9HIPa+ZinXn # sN02Kk1Qw0QwUqzaQy9W/gIquI0KOjw0LmoW9M/8S0lrjpEq2eEeUw9WQLhhUEIi # rFxGPtjqiCLiiS9CZ+kf2vWLJKUspkYv+OHT3q805Zg1dJsBFAzEYUFLb1mhmigD # EO9bsMorjECIL2ijE5zHtbGkalrrsPWu8tiDT/B7P9GSYzKfOOy4PoOIfWSK0Ixl # S7IxghpwMIIabAIBATBpMFkxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxT # aWduIG52LXNhMS8wLQYDVQQDEyZHbG9iYWxTaWduIEdDQyBSNDUgQ29kZVNpZ25p # bmcgQ0EgMjAyMAIMXLlutZE5L/uLfM4EMA0GCWCGSAFlAwQCAQUAoIGcMBkGCSqG # SIb3DQEJAzEMBgorBgEEAYI3AgEEMBwGCisGAQQBgjcCAQsxDjAMBgorBgEEAYI3 # AgEVMC8GCSqGSIb3DQEJBDEiBCBCQOBx1UgHAggWuFMS/e+VUeCV0K6lSrQ09BqX # 3jGNezAwBgorBgEEAYI3AgEMMSIwIKACgAChGoAYaHR0cHM6Ly9wdXJlc3RvcmFn # ZS5jb20gMA0GCSqGSIb3DQEBAQUABIICAEeBC9ECOFJCcsVlnaRLiYQQQnzOQe4U # eqYOAR+PNTZBWZD+je9ezBNFfluv+mpnZOQQWs/Dp6jx6LnWjcvBWph/aaBNrkbE # 4vjKV+XsLZgubb6V2iy4mx/7SYpRA72Xc0zaPWoP1JS4a2Hqtv+zNTroyufh3YoI # oQDE3yuy6yrhzwP+jIoAEc/BoL7RY09TKKTIDvXq0iPh73smkRZbbg1Ow2aSQpQX # FswSgJB5ilve/rfPy6SnKxVJWoHRNRRXJsKClB77bfYaLAl21cVC0DstoLz6gAec # RcsbB6kHMDfEGa5NxoeYYproRKXjDCpyIqqxPN7JF1b9EaFZiZk4xDQmY4rbm7gh # n/SifrKFzANLklVwEeN7PAeHE2g0+A3/Jw0SoOPq8fW62XUTA8hC2BzhRfshU1Ev # U+XsuYLr0rINK9kPLQQTzJFNoIEwhKlFDEHkD9L/CuBtF3RE0ReVq+gKQe9Czu/b # wW12N91bZMTlNBLmCr7rMXKDQBYpmUGIKaKVkgOStdLCNSdVpb1vy2cRdBunhJ1f # AIHIeKylRREc53IBv73jrCFXbeoet1h2NQhqvF834TC8wjpkAK50gVzNqPLWXe6m # BXPvMAAFI5LpJLL/LAROsHNSNbpQnlTT8QJ2XH80EdsA5LEEpA1B6vFup/5zXESq # NycMZWCgDcoaoYIXOTCCFzUGCisGAQQBgjcDAwExghclMIIXIQYJKoZIhvcNAQcC # oIIXEjCCFw4CAQMxDzANBglghkgBZQMEAgEFADB3BgsqhkiG9w0BCRABBKBoBGYw # ZAIBAQYJYIZIAYb9bAcBMDEwDQYJYIZIAWUDBAIBBQAEIOM5tsXrlK1l7QN3GGuN # McoWAodjQfNq/QD3bTXp3zVvAhB5BywykfiSqDml9h4GB+HFGA8yMDI0MTIxODE5 # NDk0MlqgghMDMIIGvDCCBKSgAwIBAgIQC65mvFq6f5WHxvnpBOMzBDANBgkqhkiG # 9w0BAQsFADBjMQswCQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4x # OzA5BgNVBAMTMkRpZ2lDZXJ0IFRydXN0ZWQgRzQgUlNBNDA5NiBTSEEyNTYgVGlt # ZVN0YW1waW5nIENBMB4XDTI0MDkyNjAwMDAwMFoXDTM1MTEyNTIzNTk1OVowQjEL # MAkGA1UEBhMCVVMxETAPBgNVBAoTCERpZ2lDZXJ0MSAwHgYDVQQDExdEaWdpQ2Vy # dCBUaW1lc3RhbXAgMjAyNDCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIB # AL5qc5/2lSGrljC6W23mWaO16P2RHxjEiDtqmeOlwf0KMCBDEr4IxHRGd7+L660x # 5XltSVhhK64zi9CeC9B6lUdXM0s71EOcRe8+CEJp+3R2O8oo76EO7o5tLuslxdr9 # Qq82aKcpA9O//X6QE+AcaU/byaCagLD/GLoUb35SfWHh43rOH3bpLEx7pZ7avVnp # UVmPvkxT8c2a2yC0WMp8hMu60tZR0ChaV76Nhnj37DEYTX9ReNZ8hIOYe4jl7/r4 # 19CvEYVIrH6sN00yx49boUuumF9i2T8UuKGn9966fR5X6kgXj3o5WHhHVO+NBikD # O0mlUh902wS/Eeh8F/UFaRp1z5SnROHwSJ+QQRZ1fisD8UTVDSupWJNstVkiqLq+ # ISTdEjJKGjVfIcsgA4l9cbk8Smlzddh4EfvFrpVNnes4c16Jidj5XiPVdsn5n10j # xmGpxoMc6iPkoaDhi6JjHd5ibfdp5uzIXp4P0wXkgNs+CO/CacBqU0R4k+8h6gYl # dp4FCMgrXdKWfM4N0u25OEAuEa3JyidxW48jwBqIJqImd93NRxvd1aepSeNeREXA # u2xUDEW8aqzFQDYmr9ZONuc2MhTMizchNULpUEoA6Vva7b1XCB+1rxvbKmLqfY/M # /SdV6mwWTyeVy5Z/JkvMFpnQy5wR14GJcv6dQ4aEKOX5AgMBAAGjggGLMIIBhzAO # BgNVHQ8BAf8EBAMCB4AwDAYDVR0TAQH/BAIwADAWBgNVHSUBAf8EDDAKBggrBgEF # BQcDCDAgBgNVHSAEGTAXMAgGBmeBDAEEAjALBglghkgBhv1sBwEwHwYDVR0jBBgw # FoAUuhbZbU2FL3MpdpovdYxqII+eyG8wHQYDVR0OBBYEFJ9XLAN3DigVkGalY17u # T5IfdqBbMFoGA1UdHwRTMFEwT6BNoEuGSWh0dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNv # bS9EaWdpQ2VydFRydXN0ZWRHNFJTQTQwOTZTSEEyNTZUaW1lU3RhbXBpbmdDQS5j # cmwwgZAGCCsGAQUFBwEBBIGDMIGAMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5k # aWdpY2VydC5jb20wWAYIKwYBBQUHMAKGTGh0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0 # LmNvbS9EaWdpQ2VydFRydXN0ZWRHNFJTQTQwOTZTSEEyNTZUaW1lU3RhbXBpbmdD # QS5jcnQwDQYJKoZIhvcNAQELBQADggIBAD2tHh92mVvjOIQSR9lDkfYR25tOCB3R # KE/P09x7gUsmXqt40ouRl3lj+8QioVYq3igpwrPvBmZdrlWBb0HvqT00nFSXgmUr # DKNSQqGTdpjHsPy+LaalTW0qVjvUBhcHzBMutB6HzeledbDCzFzUy34VarPnvIWr # qVogK0qM8gJhh/+qDEAIdO/KkYesLyTVOoJ4eTq7gj9UFAL1UruJKlTnCVaM2UeU # UW/8z3fvjxhN6hdT98Vr2FYlCS7Mbb4Hv5swO+aAXxWUm3WpByXtgVQxiBlTVYzq # fLDbe9PpBKDBfk+rabTFDZXoUke7zPgtd7/fvWTlCs30VAGEsshJmLbJ6ZbQ/xll # /HjO9JbNVekBv2Tgem+mLptR7yIrpaidRJXrI+UzB6vAlk/8a1u7cIqV0yef4uaZ # FORNekUgQHTqddmsPCEIYQP7xGxZBIhdmm4bhYsVA6G2WgNFYagLDBzpmk9104WQ # zYuVNsxyoVLObhx3RugaEGru+SojW4dHPoWrUhftNpFC5H7QEY7MhKRyrBe7ucyk # W7eaCuWBsBb4HOKRFVDcrZgdwaSIqMDiCLg4D+TPVgKx2EgEdeoHNHT9l3ZDBD+X # gbF+23/zBjeCtxz+dL/9NWR6P2eZRi7zcEO1xwcdcqJsyz/JceENc2Sg8h3KeFUC # S7tpFk7CrDqkMIIGrjCCBJagAwIBAgIQBzY3tyRUfNhHrP0oZipeWzANBgkqhkiG # 9w0BAQsFADBiMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkw # FwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVz # dGVkIFJvb3QgRzQwHhcNMjIwMzIzMDAwMDAwWhcNMzcwMzIyMjM1OTU5WjBjMQsw # CQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xOzA5BgNVBAMTMkRp # Z2lDZXJ0IFRydXN0ZWQgRzQgUlNBNDA5NiBTSEEyNTYgVGltZVN0YW1waW5nIENB # MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAxoY1BkmzwT1ySVFVxyUD # xPKRN6mXUaHW0oPRnkyibaCwzIP5WvYRoUQVQl+kiPNo+n3znIkLf50fng8zH1AT # CyZzlm34V6gCff1DtITaEfFzsbPuK4CEiiIY3+vaPcQXf6sZKz5C3GeO6lE98NZW # 1OcoLevTsbV15x8GZY2UKdPZ7Gnf2ZCHRgB720RBidx8ald68Dd5n12sy+iEZLRS # 8nZH92GDGd1ftFQLIWhuNyG7QKxfst5Kfc71ORJn7w6lY2zkpsUdzTYNXNXmG6jB # ZHRAp8ByxbpOH7G1WE15/tePc5OsLDnipUjW8LAxE6lXKZYnLvWHpo9OdhVVJnCY # Jn+gGkcgQ+NDY4B7dW4nJZCYOjgRs/b2nuY7W+yB3iIU2YIqx5K/oN7jPqJz+ucf # WmyU8lKVEStYdEAoq3NDzt9KoRxrOMUp88qqlnNCaJ+2RrOdOqPVA+C/8KI8ykLc # GEh/FDTP0kyr75s9/g64ZCr6dSgkQe1CvwWcZklSUPRR8zZJTYsg0ixXNXkrqPNF # YLwjjVj33GHek/45wPmyMKVM1+mYSlg+0wOI/rOP015LdhJRk8mMDDtbiiKowSYI # +RQQEgN9XyO7ZONj4KbhPvbCdLI/Hgl27KtdRnXiYKNYCQEoAA6EVO7O6V3IXjAS # vUaetdN2udIOa5kM0jO0zbECAwEAAaOCAV0wggFZMBIGA1UdEwEB/wQIMAYBAf8C # AQAwHQYDVR0OBBYEFLoW2W1NhS9zKXaaL3WMaiCPnshvMB8GA1UdIwQYMBaAFOzX # 44LScV1kTN8uZz/nupiuHA9PMA4GA1UdDwEB/wQEAwIBhjATBgNVHSUEDDAKBggr # BgEFBQcDCDB3BggrBgEFBQcBAQRrMGkwJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3Nw # LmRpZ2ljZXJ0LmNvbTBBBggrBgEFBQcwAoY1aHR0cDovL2NhY2VydHMuZGlnaWNl # cnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZFJvb3RHNC5jcnQwQwYDVR0fBDwwOjA4oDag # NIYyaHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZFJvb3RH # NC5jcmwwIAYDVR0gBBkwFzAIBgZngQwBBAIwCwYJYIZIAYb9bAcBMA0GCSqGSIb3 # DQEBCwUAA4ICAQB9WY7Ak7ZvmKlEIgF+ZtbYIULhsBguEE0TzzBTzr8Y+8dQXeJL # Kftwig2qKWn8acHPHQfpPmDI2AvlXFvXbYf6hCAlNDFnzbYSlm/EUExiHQwIgqgW # valWzxVzjQEiJc6VaT9Hd/tydBTX/6tPiix6q4XNQ1/tYLaqT5Fmniye4Iqs5f2M # vGQmh2ySvZ180HAKfO+ovHVPulr3qRCyXen/KFSJ8NWKcXZl2szwcqMj+sAngkSu # mScbqyQeJsG33irr9p6xeZmBo1aGqwpFyd/EjaDnmPv7pp1yr8THwcFqcdnGE4AJ # xLafzYeHJLtPo0m5d2aR8XKc6UsCUqc3fpNTrDsdCEkPlM05et3/JWOZJyw9P2un # 8WbDQc1PtkCbISFA0LcTJM3cHXg65J6t5TRxktcma+Q4c6umAU+9Pzt4rUyt+8SV # e+0KXzM5h0F4ejjpnOHdI/0dKNPH+ejxmF/7K9h+8kaddSweJywm228Vex4Ziza4 # k9Tm8heZWcpw8De/mADfIBZPJ/tgZxahZrrdVcA6KYawmKAr7ZVBtzrVFZgxtGIJ # Dwq9gdkT/r+k0fNX2bwE+oLeMt8EifAAzV3C+dAjfwAL5HYCJtnwZXZCpimHCUcr # 5n8apIUP/JiW9lVUKx+A+sDyDivl1vupL0QVSucTDh3bNzgaoSv27dZ8/DCCBY0w # ggR1oAMCAQICEA6bGI750C3n79tQ4ghAGFowDQYJKoZIhvcNAQEMBQAwZTELMAkG # A1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRp # Z2ljZXJ0LmNvbTEkMCIGA1UEAxMbRGlnaUNlcnQgQXNzdXJlZCBJRCBSb290IENB # MB4XDTIyMDgwMTAwMDAwMFoXDTMxMTEwOTIzNTk1OVowYjELMAkGA1UEBhMCVVMx # FTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNv # bTEhMB8GA1UEAxMYRGlnaUNlcnQgVHJ1c3RlZCBSb290IEc0MIICIjANBgkqhkiG # 9w0BAQEFAAOCAg8AMIICCgKCAgEAv+aQc2jeu+RdSjwwIjBpM+zCpyUuySE98orY # WcLhKac9WKt2ms2uexuEDcQwH/MbpDgW61bGl20dq7J58soR0uRf1gU8Ug9SH8ae # FaV+vp+pVxZZVXKvaJNwwrK6dZlqczKU0RBEEC7fgvMHhOZ0O21x4i0MG+4g1ckg # HWMpLc7sXk7Ik/ghYZs06wXGXuxbGrzryc/NrDRAX7F6Zu53yEioZldXn1RYjgwr # t0+nMNlW7sp7XeOtyU9e5TXnMcvak17cjo+A2raRmECQecN4x7axxLVqGDgDEI3Y # 1DekLgV9iPWCPhCRcKtVgkEy19sEcypukQF8IUzUvK4bA3VdeGbZOjFEmjNAvwjX # WkmkwuapoGfdpCe8oU85tRFYF/ckXEaPZPfBaYh2mHY9WV1CdoeJl2l6SPDgohIb # Zpp0yt5LHucOY67m1O+SkjqePdwA5EUlibaaRBkrfsCUtNJhbesz2cXfSwQAzH0c # lcOP9yGyshG3u3/y1YxwLEFgqrFjGESVGnZifvaAsPvoZKYz0YkH4b235kOkGLim # dwHhD5QMIR2yVCkliWzlDlJRR3S+Jqy2QXXeeqxfjT/JvNNBERJb5RBQ6zHFynIW # IgnffEx1P2PsIV/EIFFrb7GrhotPwtZFX50g/KEexcCPorF+CiaZ9eRpL5gdLfXZ # qbId5RsCAwEAAaOCATowggE2MA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFOzX # 44LScV1kTN8uZz/nupiuHA9PMB8GA1UdIwQYMBaAFEXroq/0ksuCMS1Ri6enIZ3z # bcgPMA4GA1UdDwEB/wQEAwIBhjB5BggrBgEFBQcBAQRtMGswJAYIKwYBBQUHMAGG # GGh0dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBDBggrBgEFBQcwAoY3aHR0cDovL2Nh # Y2VydHMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9vdENBLmNydDBF # BgNVHR8EPjA8MDqgOKA2hjRodHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGlnaUNl # cnRBc3N1cmVkSURSb290Q0EuY3JsMBEGA1UdIAQKMAgwBgYEVR0gADANBgkqhkiG # 9w0BAQwFAAOCAQEAcKC/Q1xV5zhfoKN0Gz22Ftf3v1cHvZqsoYcs7IVeqRq7IviH # GmlUIu2kiHdtvRoU9BNKei8ttzjv9P+Aufih9/Jy3iS8UgPITtAq3votVs/59Pes # MHqai7Je1M/RQ0SbQyHrlnKhSLSZy51PpwYDE3cnRNTnf+hZqPC/Lwum6fI0POz3 # A8eHqNJMQBk1RmppVLC4oVaO7KTVPeix3P0c2PR3WlxUjG/voVA9/HYJaISfb8rb # II01YBwCA8sgsKxYoA5AY8WYIsGyWfVVa88nq2x2zm8jLfR+cWojayL/ErhULSd+ # 2DrZ8LaHlv1b0VysGMNNn3O3AamfV6peKOK5lDGCA3YwggNyAgEBMHcwYzELMAkG # A1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMTswOQYDVQQDEzJEaWdp # Q2VydCBUcnVzdGVkIEc0IFJTQTQwOTYgU0hBMjU2IFRpbWVTdGFtcGluZyBDQQIQ # C65mvFq6f5WHxvnpBOMzBDANBglghkgBZQMEAgEFAKCB0TAaBgkqhkiG9w0BCQMx # DQYLKoZIhvcNAQkQAQQwHAYJKoZIhvcNAQkFMQ8XDTI0MTIxODE5NDk0MlowKwYL # KoZIhvcNAQkQAgwxHDAaMBgwFgQU29OF7mLb0j575PZxSFCHJNWGW0UwLwYJKoZI # hvcNAQkEMSIEIB/S9BqdD6gdBZChUk81C7xJSMCKYbybJgI8uTub7GhKMDcGCyqG # SIb3DQEJEAIvMSgwJjAkMCIEIHZ2n6jyYy8fQws6IzCu1lZ1/tdz2wXWZbkFk5hD # j5rbMA0GCSqGSIb3DQEBAQUABIICAHBG//GSsIX+qbDyBGrZjBLTo/ciwxuCsMV4 # ymDtR6FzZZAhTNsg3Ms5EItOS8wrtx6B6plhbzXq5fIIuSMDCglCAaESA9BHMUoI # 8hO3iBsLwWKk/JJBZ/6aVNj+9U3lavq4lmJHSNAmdZWbA2FBQDorDTgAWtLv2Iw+ # /JW910yJy4/MQiiMaDmL3202mAR+Qoir0raqfEp/oQXXwgGUYVsNEMwq3vMSVVPQ # SwI27Lrvc+Oe1nXg5NrcG8C3E2syTyTwoBgzCQveIw/CqMoK6d+er+Kg+vrTU4iA # TXqMZfWboNJAUHbCN65NE/dYrbjgeXPtmcFc7rYuJOd41JHGl8kEtJwHXOKCwnci # I8/BOvX/g0W5OqVUoCRwaIAeheSJYcI/oRM1N+uVli5GUiKtEjHO8IueloOVR0Bj # +6Zek2oiUR++E5s1iuCs010Smp/ccHZkDb7jLrsQ300qid0ulZmN93ja0mR6VE1l # eJC4yFVdycRMP/MggTNhh/DaFLBlJgZNcAGC496FOoSQojx8S1JDR739sq83EVu0 # fo8E4i88w20drYgzpCUPnjXtt+4VP93TcSTBAdoGbs5kEcRI7wijd+aW9oRJ9q5v # lj09sLPs/brbHUH31p+glPLTtZV8UcEeDIbgg1C17QaNu8dGRWuufuVIuQTmy9If # 3wFaVkPl # SIG # End signature block |