VCF module beta

VCF module beta

Author: codyhosterman

PureStorage.FlashArray.VMware.Configuration/PureStorage.FlashArray.VMware.Configuration.psd1

@@ -82,7 +82,7 @@
 	NestedModules = @()
 
 	# Functions to export from this module
-	FunctionsToExport = 'New-PfaRestOperation','New-PfaConnection','Get-PfaDatastore','Get-PfaConnectionOfDatastore','New-PfaRestSession','Remove-PfaRestSession','New-PfaHostFromVmHost','Get-PfaHostFromVmHost','Get-PfaHostGroupfromVcCluster','New-PfaHostGroupfromVcCluster','Set-VmHostPfaiSCSI','Set-ClusterPfaiSCSI','get-PfaConnectionFromArrayId','Initialize-PfaVcfWorkloadDomain'
+	FunctionsToExport = 'New-PfaRestOperation','New-PfaConnection','Get-PfaDatastore','Get-PfaConnectionOfDatastore','New-PfaRestSession','Remove-PfaRestSession','New-PfaHostFromVmHost','Get-PfaHostFromVmHost','Get-PfaHostGroupfromVcCluster','New-PfaHostGroupfromVcCluster','Set-VmHostPfaiSCSI','Set-ClusterPfaiSCSI','get-PfaConnectionFromArrayId'
 
 	# Cmdlets to export from this module
 	CmdletsToExport = '*'

PureStorage.FlashArray.VMware.Configuration/PureStorage.FlashArray.VMware.Configuration.psm1

@@ -1260,196 +1260,6 @@ function Set-ClusterPfaiSCSI {
       return $allEsxiiSCSItargets
     }
 }
-function Initialize-PfaVcfWorkloadDomain {
-  <#
-  .SYNOPSIS
-    Configures a workload domain for Pure Storage
-  .DESCRIPTION
-    Connects to each ESXi host, configures initiators on the FlashArray and provisions a VMFS. If something fails it will cleanup any changes.
-  .INPUTS
-    FQDNs or IPs of each host, valid credentials, a FlashArray connection, a datastore name and size.
-  .OUTPUTS
-    Returns host group.
-  .NOTES
-    Version:        2.0
-    Author:         Cody Hosterman https://codyhosterman.com
-    Creation Date:  08/24/2020
-    Purpose/Change: Core support
-  .EXAMPLE
-    PS C:\ $faCreds = get-credential
-    PS C:\ New-PfaConnection -endpoint flasharray-m20-2 -credentials $faCreds -ignoreCertificateError -defaultArray
-    PS C:\ $creds = get-credential
-    PS C:\ Initialize-PfaVcfWorkloadDomain -esxiHosts "esxi-02.purecloud.com","esxi-04.purecloud.com" -credentials $creds -datastoreName "vcftest" -sizeInTB 16 -fc
-    
-    Creates a host group and hosts and provisions a 16 TB VMFS to the hosts over FC
-  .EXAMPLE
-    PS C:\ $faCreds = get-credential
-    PS C:\ New-PfaConnection -endpoint flasharray-m20-2 -credentials $faCreds -ignoreCertificateError -defaultArray
-    PS C:\ $creds = get-credential
-    PS C:\ $allHosts = @()
-    PS C:\ Import-Csv C:\hostList.csv | ForEach-Object {$allHosts += $_.hostnames} 
-    PS C:\ Initialize-PfaVcfWorkloadDomain -esxiHosts $allHosts -credentials $creds -datastoreName "vcftest" -sizeInTB 16 -fc
-    
-    Creates a host group and hosts and provisions a 16 TB VMFS to the hosts over FC. This takes in a csv file of ESXi host FQDNs with one csv header called hostnames
-  
-  *******Disclaimer:******************************************************
-  This scripts are offered "as is" with no warranty.  While this 
-  scripts is tested and working in my environment, it is recommended that you test 
-  this script in a test lab before using in a production environment. Everyone can 
-  use the scripts/commands provided here without any written permission but I
-  will not be liable for any damage or loss to the system.
-  ************************************************************************
-  #>
-
-  [CmdletBinding()]
-  Param(
-
-      [Parameter(Position=0,mandatory=$true)]
-      [string[]]$EsxiHosts,
-
-      [Parameter(Position=1,ValueFromPipeline=$True,mandatory=$true)]
-      [System.Management.Automation.PSCredential]$Credentials,
-
-      [Parameter(Position=1,ValueFromPipeline=$True)]
-      [PurePowerShell.PureArray]$Flasharray,
-
-      [Parameter(Position=2,mandatory=$true)]
-      [string]$DatastoreName,
-
-      [Parameter(Position=3)]
-      [int]$SizeInGB,
-
-      [Parameter(Position=4)]
-      [int]$SizeInTB,
-
-      [Parameter(Position=5)]
-      [switch]$Fc
-    
-  )
-  if ($fc -ne $true)
-  {
-    throw "Please indicate protocol type. Currently only -fc is a supported option."
-  }
-  $ErrorActionPreference = "stop"
-  if (($sizeInGB -eq 0) -and ($sizeInTB -eq 0))
-  {
-      throw "Please enter a size in GB or TB"
-  }
-  elseif (($sizeInGB -ne 0) -and ($sizeInTB -ne 0)) {
-      throw "Please only enter a size in TB or GB, not both."
-  }
-  elseif ($sizeInGB -ne 0) {
-      $volSize = $sizeInGB * 1024 *1024 *1024   
-  }
-  else {
-      $volSize = $sizeInTB * 1024 *1024 *1024 * 1024
-  }
-  if ($null -eq $flasharray)
-  {
-    $flasharray = checkDefaultFlashArray
-  }
-  $esxiConnections = @()
-  for ($i =0;$i -lt $esxiHosts.count;$i++)
-  {
-    try {
-         $esxiConnections += connect-viserver -Server $esxiHosts[$i] -Credential ($Credentials) -ErrorAction Stop
-    }
-    catch
-    {
-      $scriptCleanupStep = 0
-      cleanup-pfaVcf
-    }
-  }
-  $faHosts = @()
-  for ($i =0;$i -lt $esxiConnections.count;$i++)
-  {
-    $foundHost = $null
-    try {
-        $foundHost = Get-PfaHostFromVmHost -esxi (get-vmhost $esxiConnections[$i].name) 
-        if ($null -ne $foundHost)
-        {
-          if ($faHosts.count -ge 1)
-          {
-            $scriptCleanupStep = 1
-          }
-          else
-          {
-            $scriptCleanupStep = 6
-          }
-          $esxiName =$esxiConnections[$i].name
-          cleanup-pfaVcf
-          $newError =   ("The host " + $esxiName + " already exists on the FlashArray. Ensure you entered the right host and/or array")
-          throw ""
-        }
-    }
-    catch {
-      if ($null -ne $newError)
-      {
-        throw $newError
-      }
-    }
-    try{
-      $faHosts += (New-PfaHostFromVmHost -esxi (get-vmhost $esxiConnections[$i].name) -FC:$fc -ErrorAction Stop).name
-    }
-    catch
-    { 
-        $scriptCleanupStep = 1
-        cleanup-pfaVcf
-        throw $_.Exception
-    }      
-  }
-  $groupName = ("vCF-WorkloadDomain-" + (get-random -Maximum 9999 -Minimum 1000))
-  try{
-    $hostGroup = New-PfaHostGroup -Array $flasharray -Hosts $fahosts -Name $groupName -ErrorAction Stop
-  }
-  catch
-  {
-     $scriptCleanupStep = 2
-     cleanup-pfaVcf
-     throw $_.Exception
-  }
-  try
-  {
-      $newVol = New-PfaVolume -Array $flasharray -Size $volSize -VolumeName $datastoreName -ErrorAction Stop
-  }
-  catch
-  {
-      $scriptCleanupStep = 3
-      cleanup-pfaVcf
-      throw $_.Exception
-  }
-  $Global:CurrentFlashArray = $flasharray
-  try
-  {
-      New-PfaHostGroupVolumeConnection -Array $flasharray -VolumeName $newVol.name -HostGroupName $groupName -ErrorAction Stop|Out-Null
-  }
-  catch
-  {
-      $scriptCleanupStep = 4
-      cleanup-pfaVcf
-      throw $_.Exception
-  }
-  $newNAA =  "naa.624a9370" + $newVol.serial.toLower()
-  $esxi = $esxiConnections |Select-Object -Last 1
-  get-vmhost $esxi.name |Get-VMHostStorage -RescanAllHba  |Out-Null
-  try 
-  {
-      $newVMFS = get-vmhost $esxi.name |new-datastore -name $datastoreName -vmfs -Path $newNAA -FileSystemVersion 6 -ErrorAction Stop
-  }
-  catch 
-  {
-      $scriptCleanupStep = 5
-      cleanup-pfaVcf
-      throw $_.Exception
-  }
-  foreach ($esxiConnection in $esxiConnections)
-  {
-     get-vmhost $esxiConnection.name | Get-VMHostStorage -RescanAllHba  |Out-Null
-  } 
-  $scriptCleanupStep = 7
-  cleanup-pfaVcf
-  return $hostGroup
-}
 function New-PfaRestOperation {
   <#
   .SYNOPSIS
@@ -1599,46 +1409,6 @@ New-Alias -Name Set-clusterPureFAiSCSI -Value Set-clusterPfaiSCSI
 
 
 #### helper functions
-function Cleanup-PfaVcf{
-  if ($scriptCleanupStep -lt 6)
-  {
-    if ($scriptCleanupStep -eq 5)
-    {
-        Remove-PfaHostGroupVolumeConnection -Array $flasharray -VolumeName $datastoreName -HostGroupName $groupName |Out-Null
-    }
-    if ($scriptCleanupStep -ge 4)
-    {
-      Remove-PfaVolumeOrSnapshot -Array $flasharray -Name $datastoreName |Out-Null
-      Remove-PfaVolumeOrSnapshot -Array $flasharray -Name $datastoreName -Eradicate |Out-Null
-    }
-    if ($scriptCleanupStep -ge 1)
-    {
-      foreach ($faHost in $faHosts)
-      {
-        Remove-PfaHost -Array $flasharray -Name $faHost |out-null
-      }
-    }
-    if ($scriptCleanupStep -ge 3)
-    {
-      remove-PfaHostGroup -Array $flasharray -Name $groupName |out-null
-    }
-  }
-  if ($scriptCleanupStep -ge 0)
-  {
-    if ($esxiConnections.count -eq 0)
-    {
-      return
-    }
-    else
-    {
-        foreach ($esxiConnection in $esxiConnections)
-        {
-          $esxiConnection | disconnect-viserver -confirm:$false |out-null
-        }
-    }
-  }
-  return
-}
 function checkDefaultFlashArray{
     if ($null -eq $Global:DefaultFlashArray)
     {

PureStorage.FlashArray.VMware.VCF/PureStorage.FlashArray.VMware.VCF.psd1

@@ -0,0 +1,135 @@
+<#	
+	===========================================================================
+	 Created with: 	VSCode
+	 Created by:   	Cody Hosterman
+	 Organization: 	Pure Storage, Inc.
+	 Filename:     	PureStorage.FlashArray.VMware.VCF.psd1
+	 Version:		2.0.0.0
+	 Copyright:		2020 Pure Storage, Inc.
+	-------------------------------------------------------------------------
+	 Module Name: PureStorageFlashArrayVMwareVMFSPowerShell
+	Disclaimer
+ 	The sample script and documentation are provided AS IS and are not supported by 
+	the author or the author's employer, unless otherwise agreed in writing. You bear 
+	all risk relating to the use or performance of the sample script and documentation. 
+	The author and the author's employer disclaim all express or implied warranties 
+	(including, without limitation, any warranties of merchantability, title, infringement 
+	or fitness for a particular purpose). In no event shall the author, the author's employer 
+	or anyone else involved in the creation, production, or delivery of the scripts be liable 
+	for any damages whatsoever arising out of the use or performance of the sample script and 
+	documentation (including, without limitation, damages for loss of business profits, 
+	business interruption, loss of business information, or other pecuniary loss), even if 
+	such person has been advised of the possibility of such damages.
+	===========================================================================
+#>
+
+@{
+	CompatiblePSEditions = @('Desktop', 'Core')
+	# Script module or binary module file associated with this manifest.
+	RootModule = 'PureStorage.FlashArray.VMware.VCF.psm1'
+	
+	# Version number of this module; major.minor[.build[.revision]]
+	ModuleVersion = '2.0.0.0'
+	
+	# ID used to uniquely identify this module
+	GUID = 'd722807a-d903-490a-a1d9-418fd8d90591'
+	
+	# Author of this module
+	Author = 'Pure Storage'
+	
+	# Company or vendor of this module
+	CompanyName = 'Pure Storage, Inc.'
+	
+	# Copyright statement for this module
+	Copyright = '(c) 2020 Pure Storage, Inc. All rights reserved.'
+	
+	# Description of the functionality provided by this module
+	Description = 'Pure Storage FlashArray VMware PowerShell VMFS management.'
+	
+	# Minimum version of the Windows PowerShell engine required by this module
+	PowerShellVersion = '5.1'
+	
+	# Name of the Windows PowerShell host required by this module
+	PowerShellHostName = ''
+	
+	# Minimum version of the Windows PowerShell host required by this module
+	PowerShellHostVersion = ''
+	
+	# Minimum version of Microsoft .NET Framework required by this module
+	DotNetFrameworkVersion = ''
+	
+	# Minimum version of the common language runtime (CLR) required by this module
+	CLRVersion = ''
+	
+	# Modules that must be imported into the global environment prior to importing this module
+	RequiredModules = @(
+		@{"ModuleName"="PureStoragePowerShellSDK";"ModuleVersion"="1.13.1.12"}
+		@{"ModuleName"="PureStorage.FlashArray.VMware.Configuration";"ModuleVersion"="2.0.0.0"}
+		@{"ModuleName"="PowerVCF";"ModuleVersion"="2.1.0"}
+    )
+	
+	# Assemblies that must be loaded prior to importing this module
+	RequiredAssemblies = @()
+	
+	# Script files (.ps1) that are run in the caller's environment prior to importing this module.
+	ScriptsToProcess = @()
+	
+	# Type files (.ps1xml) to be loaded when importing this module
+	TypesToProcess = @()
+	
+	# Format files (.ps1xml) to be loaded when importing this module
+	FormatsToProcess = @()
+	
+	# Modules to import as nested modules of the module specified in RootModule/ModuleToProcess
+	NestedModules = @()
+	
+	# Functions to export from this module
+	FunctionsToExport = 'Initialize-PfaVcfWorkloadDomain','Get-PfaVcfVasaProvider','New-PfaVcfVasaProvider'
+	
+	# Cmdlets to export from this module
+	CmdletsToExport = '*'
+	
+	# Variables to export from this module
+	VariablesToExport = ''
+	
+	# Aliases to export from this module
+	AliasesToExport = ''
+	
+	# List of all modules packaged with this module
+	ModuleList = @()
+	
+	# List of all files packaged with this module
+	FileList = @()
+	
+	# Private data to pass to the module specified in ModuleToProcess
+	PrivateData = @{
+		
+		#Support for PowerShellGet galleries.
+		PSData = @{
+			
+			# Tags applied to this module. These help with module discovery in online galleries.
+			# Tags = @()
+			
+			# A URL to the license for this module.
+			# LicenseUri = ''
+			
+			# A URL to the main website for this project.
+			# ProjectUri = ''
+			
+			# A URL to an icon representing this module.
+			# IconUri = ''
+			
+			# ReleaseNotes of this module
+			# ReleaseNotes = ''
+			
+		}
+		
+	}
+	
+	# HelpInfo URI of this module
+	HelpInfoURI = 'https://www.codyhosterman.com'
+	
+	# Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix.
+	DefaultCommandPrefix = ''
+	
+}