248a86f0a2
Fixes #535 - module using sort instead of sort-object causing unexpected behavior on powershell core/Linux. Instead of only addressing the issue at hand, I looked for other instances of sort being used instead of sort-object for other modules within this repo and corrected those as well. I think I got most of them, but feel free to raise another issue if you find another. If the sort was in an example/help statement, or was inside the logic/process of the function, I replaced sort with sort-object. In the one case where the sort was only applied to the output I removed the statement -- this way the function user can add the sort in their script and not have to sort output twice. I changed a couple select/where with select-object/where-object along the way as well just as I saw them. Signed-off-by: Brian Wuchner <brian.wuchner@gmail.com>
246 lines
9.2 KiB
PowerShell
246 lines
9.2 KiB
PowerShell
<#
|
|
.SYNOPSIS Datastore Functions
|
|
.DESCRIPTION A collection of functions to manipulate datastore Mount + Attach status
|
|
.EXAMPLE Get-Datastore | Get-DatastoreMountInfo | Sort Datastore, VMHost | FT -AutoSize
|
|
.EXAMPLE Get-Datastore IX2ISCSI01 | Unmount-Datastore
|
|
.EXAMPLE Get-Datastore IX2ISCSI01 | Get-DatastoreMountInfo | Sort Datastore, VMHost | FT -AutoSize
|
|
.EXAMPLE Get-Datastore IX2iSCSI01 | Mount-Datastore
|
|
.EXAMPLE Get-Datastore IX2iSCSI01 | Get-DatastoreMountInfo | Sort Datastore, VMHost | FT -AutoSize
|
|
.EXAMPLE Get-Datastore IX2iSCSI01 | Detach-Datastore
|
|
.EXAMPLE Get-Datastore IX2iSCSI01 | Get-DatastoreMountInfo | Sort Datastore, VMHost | FT -AutoSize
|
|
.EXAMPLE Get-Datastore IX2iSCSI01 | Attach-datastore
|
|
.EXAMPLE Get-Datastore IX2iSCSI01 | Get-DatastoreMountInfo | Sort Datastore, VMHost | FT -AutoSize
|
|
.NOTES Written by Alan Renouf, originally published at https://blogs.vmware.com/vsphere/2012/01/automating-datastore-storage-device-detachment-in-vsphere-5.html
|
|
.NOTES May 2017: Modified by Jason Coleman (virtuallyjason.blogspot.com), to improve performance when dealing with a large number of hosts and datastores
|
|
#>
|
|
Function Get-HostViews {
|
|
[CmdletBinding()]
|
|
Param (
|
|
$Datastore
|
|
)
|
|
Begin{
|
|
$allDatastores = @()
|
|
}
|
|
Process {
|
|
$allDatastores += $Datastore
|
|
}
|
|
End {
|
|
#Build the array of Datastore Objects
|
|
if (-not $Datastore) {
|
|
$allDatastores = Get-Datastore
|
|
}
|
|
$allDatastores = $allDatastores | ? {$_.pstypenames -contains "VMware.VimAutomation.ViCore.Impl.V1.DatastoreManagement.DatastoreImpl"}
|
|
if (-not $allDatastores){
|
|
Throw "No Datastores found.`nIs ""$Datastore"" a Datastore Object?"
|
|
}
|
|
$allHosts = @()
|
|
$DShostsKeys = $allDatastores.extensiondata.host.key.value | sort-object | get-unique -asstring
|
|
$DShosts = foreach ($thisKey in $DShostsKeys) {($allDatastores.extensiondata.host | ? {$_.key.value -eq $thisKey})[0]}
|
|
$i = 1
|
|
foreach ($DSHost in $DSHosts){
|
|
write-progress -activity "Collecting ESXi Host Views" -status "Querying $($dshost.key)..." -percentComplete ($i++/$DSHosts.count*100)
|
|
$hostObj = "" | select keyValue,hostView,storageSys
|
|
$hostObj.hostView = get-view $DSHost.key
|
|
$hostObj.keyValue = $DSHost.key.value
|
|
$hostObj.storageSys = Get-View $hostObj.hostView.ConfigManager.StorageSystem
|
|
$allHosts += $hostObj
|
|
}
|
|
write-progress -activity "Collecting ESXi Host Views" -completed
|
|
$allHosts
|
|
}
|
|
}
|
|
|
|
Function Get-DatastoreMountInfo {
|
|
[CmdletBinding()]
|
|
Param (
|
|
[Parameter(ValueFromPipeline=$true)]
|
|
$Datastore
|
|
)
|
|
#Roll back up an unrolled array from a pipeline
|
|
Begin{
|
|
$allDatastores = @()
|
|
}
|
|
Process {
|
|
$allDatastores += $Datastore
|
|
}
|
|
End {
|
|
$AllInfo = @()
|
|
#Build the array of Datastore Objects
|
|
if (-not $Datastore) {
|
|
$allDatastores = Get-Datastore
|
|
}
|
|
$allDatastores = $allDatastores | ? {$_.pstypenames -contains "VMware.VimAutomation.ViCore.Impl.V1.DatastoreManagement.DatastoreImpl"}
|
|
if (-not $allDatastores){
|
|
Throw "No Datastores found.`nIs ""$Datastore"" a Datastore Object?"
|
|
}
|
|
$allDatastoreNAAs = foreach ($ds in $allDatastores) {$ds.ExtensionData.Info.vmfs.extent[0].diskname}
|
|
|
|
#Build the array of custom Host Objects
|
|
$allHosts = Get-HostViews -datastore $allDatastores
|
|
$output = @()
|
|
$i = 1
|
|
foreach ($dsHost in $allHosts){
|
|
write-progress -activity "Checking Datastore access" -status "Checking $($dshost.hostview.name)..." -percentComplete ($i++ / $allHosts.count * 100)
|
|
#Get all devices on the host that match the list of $allDatastoreNAAs
|
|
$devices = $dsHost.storagesys.StorageDeviceInfo.ScsiLun
|
|
foreach ($device in $devices){
|
|
if ($allDatastoreNAAs -contains $device.canonicalName){
|
|
#Record information about this device/host combo
|
|
$thisDatastore = $alldatastores | ? {$_.ExtensionData.Info.vmfs.extent[0].diskname -eq $device.canonicalName}
|
|
$hostviewDSAttachState = ""
|
|
if ($device.operationalState[0] -eq "ok") {
|
|
$hostviewDSAttachState = "Attached"
|
|
} elseif ($device.operationalState[0] -eq "off") {
|
|
$hostviewDSAttachState = "Detached"
|
|
} else {
|
|
$hostviewDSAttachState = $device.operationalstate[0]
|
|
}
|
|
$Info = "" | Select Datastore, VMHost, Lun, Mounted, State
|
|
$Info.VMHost = $dsHost.hostview.name
|
|
$Info.Datastore = $thisDatastore.name
|
|
$Info.Lun = $device.canonicalName
|
|
$Info.mounted = ($thisDatastore.extensiondata.host | ? {$_.key.value -eq $dshost.keyvalue}).mountinfo.mounted
|
|
$Info.state = $hostviewDSAttachState
|
|
$output += $info
|
|
}
|
|
}
|
|
}
|
|
write-progress -activity "Checking Datastore access" -completed
|
|
$output
|
|
}
|
|
}
|
|
|
|
Function Detach-Datastore {
|
|
[CmdletBinding()]
|
|
Param (
|
|
[Parameter(ValueFromPipeline=$true)]
|
|
$Datastore
|
|
)
|
|
Begin{
|
|
$allDatastores = @()
|
|
}
|
|
Process {
|
|
$allDatastores += $Datastore
|
|
}
|
|
End {
|
|
$allDatastores = $allDatastores | ? {$_.pstypenames -contains "VMware.VimAutomation.ViCore.Impl.V1.DatastoreManagement.DatastoreImpl"}
|
|
if (-not $allDatastores){
|
|
Throw "No Datastores found.`nIs ""$Datastore"" a Datastore Object?"
|
|
}
|
|
$allDatastoreNAAs = foreach ($ds in $allDatastores) {$ds.ExtensionData.Info.vmfs.extent[0].diskname}
|
|
$allHosts = Get-HostViews -datastore $allDatastores
|
|
$j = 1
|
|
foreach ($dsHost in $allHosts){
|
|
#Get all devices on the host that match the list of $allDatastoreNAAs
|
|
write-progress -id 1 -activity "Detaching Datastores" -status "Removing device(s) from $($dsHost.hostview.name)" -percentComplete ($j++ / $allHosts.count * 100)
|
|
$devices = $dsHost.storagesys.StorageDeviceInfo.ScsiLun | ? {$allDatastoreNAAs -contains $_.canonicalName}
|
|
$i = 1
|
|
foreach ($device in $devices){
|
|
write-progress -parentid 1 -activity "Detaching Datastores" -status "Removing device: $(($allDatastores | ? {$_.ExtensionData.Info.vmfs.extent[0].diskname -eq $device.canonicalName}).name)" -percentComplete ($i++ / $allDatastoreNAAs.count * 100)
|
|
$LunUUID = $Device.Uuid
|
|
$dsHost.storageSys.DetachScsiLun($LunUUID);
|
|
}
|
|
}
|
|
write-progress -activity "Detaching Datastores" -completed
|
|
}
|
|
}
|
|
|
|
Function Attach-Datastore {
|
|
[CmdletBinding()]
|
|
Param (
|
|
[Parameter(ValueFromPipeline=$true)]
|
|
$Datastore
|
|
)
|
|
Begin{
|
|
$allDatastores = @()
|
|
}
|
|
Process {
|
|
$allDatastores += $Datastore
|
|
}
|
|
End {
|
|
$allDatastores = $allDatastores | ? {$_.pstypenames -contains "VMware.VimAutomation.ViCore.Impl.V1.DatastoreManagement.DatastoreImpl"}
|
|
if (-not $allDatastores){
|
|
Throw "No Datastores found.`nIs ""$Datastore"" a Datastore Object?"
|
|
}
|
|
$allDatastoreNAAs = foreach ($ds in $allDatastores) {$ds.ExtensionData.Info.vmfs.extent[0].diskname}
|
|
$allHosts = Get-HostViews -datastore $allDatastores
|
|
$j = 1
|
|
foreach ($dsHost in $allHosts){
|
|
#Get all devices on the host that match the list of $allDatastoreNAAs
|
|
write-progress -id 1 -activity "Attaching Datastores" -status "Attaching devices to $($dsHost.hostview.name)" -percentComplete ($j++ / $allHosts.count * 100)
|
|
$devices = $dsHost.storagesys.StorageDeviceInfo.ScsiLun
|
|
$i = 1
|
|
foreach ($device in $devices){
|
|
write-progress -parentid 1 -activity "Attaching Datastores" -status "Attaching device: $($Device.Uuid)" -percentComplete ($i++ / $devices.count * 100)
|
|
if ($allDatastoreNAAs -contains $device.canonicalName){
|
|
$LunUUID = $Device.Uuid
|
|
$dsHost.storageSys.AttachScsiLun($LunUUID);
|
|
}
|
|
}
|
|
}
|
|
write-progress -activity "Attaching Datastores" -completed
|
|
}
|
|
}
|
|
|
|
Function Unmount-Datastore {
|
|
[CmdletBinding()]
|
|
Param (
|
|
[Parameter(ValueFromPipeline=$true)]
|
|
$Datastore
|
|
)
|
|
Begin{
|
|
$allDatastores = @()
|
|
}
|
|
Process {
|
|
$allDatastores += $Datastore
|
|
}
|
|
End {
|
|
$allDatastores = $allDatastores | ? {$_.pstypenames -contains "VMware.VimAutomation.ViCore.Impl.V1.DatastoreManagement.DatastoreImpl"}
|
|
if (-not $allDatastores){
|
|
Throw "No Datastores found.`nIs ""$Datastore"" a Datastore Object?"
|
|
}
|
|
$allHosts = Get-HostViews -datastore $allDatastores
|
|
$j = 1
|
|
foreach ($dsHost in $allHosts){
|
|
write-progress -id 1 -activity "Unmounting Datastores" -status "Unmounting devices from $($dsHost.hostview.name)" -percentComplete ($j++ / $allHosts.count * 100)
|
|
$i = 1
|
|
foreach ($ds in $allDatastores){
|
|
write-progress -parentid 1 -activity "Unmounting Datastores" -status "Unmounting device: $($ds.name)" -percentComplete ($i++ / $allDatastores.count * 100)
|
|
$dsHost.storageSys.UnmountVmfsVolume($DS.ExtensionData.Info.vmfs.uuid);
|
|
}
|
|
}
|
|
write-progress -activity "Unmounting Datastores" -completed
|
|
}
|
|
}
|
|
|
|
Function Mount-Datastore {
|
|
[CmdletBinding()]
|
|
Param (
|
|
[Parameter(ValueFromPipeline=$true)]
|
|
$Datastore
|
|
)
|
|
Begin{
|
|
$allDatastores = @()
|
|
}
|
|
Process {
|
|
$allDatastores += $Datastore
|
|
}
|
|
End {
|
|
$allDatastores = $allDatastores | ? {$_.pstypenames -contains "VMware.VimAutomation.ViCore.Impl.V1.DatastoreManagement.DatastoreImpl"}
|
|
if (-not $allDatastores){
|
|
Throw "No Datastores found.`nIs ""$Datastore"" a Datastore Object?"
|
|
}
|
|
$allHosts = Get-HostViews -datastore $allDatastores
|
|
$j = 0
|
|
foreach ($dsHost in $allHosts){
|
|
write-progress -activity "Mounting Datastores" -status "Mounting devices to $($dsHost.hostview.name)" -percentComplete ($j++ / $allHosts.count * 100)
|
|
$i = 1
|
|
foreach ($ds in $allDatastores){
|
|
write-progress -activity "Mounting Datastores" -status "Mounting device: $($DS.ExtensionData.Info.vmfs.uuid)" -percentComplete ($i++ / $allDatastores.count * 100)
|
|
$dsHost.storageSys.MountVmfsVolume($DS.ExtensionData.Info.vmfs.uuid);
|
|
}
|
|
}
|
|
write-progress -activity "Mounting Datastores" -completed
|
|
}
|
|
}
|