voltron/PowerCLI-Example-Scripts
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Updated to include configuringn Proxy Settings

Browse Source
This commit is contained in:
William Lam
2018-11-01 07:33:40 -07:00
parent 48d2db91d8
commit 578d3c5deb
2 changed files with 233 additions and 67 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
Modules/VMware.HCX/VMware.HCX.psd1
View File

@@ -36,7 +36,7 @@ Description = 'PowerShell Module for Managing Hybrid Cloud Extension (HCX) on VM
PowerShellVersion = '6.0' PowerShellVersion = '6.0'
# Functions to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no functions to export. # Functions to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no functions to export.
FunctionsToExport = 'Connect-HcxServer', 'Get-HcxCloudConfig', 'Get-HcxEndpoint', 'New-HcxMigration', 'Get-HcxMigration', 'Connect-HcxVAMI', 'Get-HcxVCConfig', 'Set-HcxLicense', 'Set-HcxVCConfig', 'Get-HcxNSXConfig', 'Set-HcxNSXConfig', 'Get-HcxCity', 'Get-HcxLocation', 'Set-HcxLocation', 'Get-HcxRoleMapping', 'Set-HcxRoleMapping' FunctionsToExport = 'Connect-HcxServer', 'Get-HcxCloudConfig', 'Get-HcxEndpoint', 'New-HcxMigration', 'Get-HcxMigration', 'Connect-HcxVAMI', 'Get-HcxVCConfig', 'Set-HcxLicense', 'Set-HcxVCConfig', 'Get-HcxNSXConfig', 'Set-HcxNSXConfig', 'Get-HcxCity', 'Get-HcxLocation', 'Set-HcxLocation', 'Get-HcxRoleMapping', 'Set-HcxRoleMapping', 'Get-HcxProxy', 'Set-HcxProxy', 'Remove-HcxProxy'
# Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export. # Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export.
CmdletsToExport = @() CmdletsToExport = @()

298
Modules/VMware.HCX/VMware.HCX.psm1
View File

@@ -1047,87 +1047,250 @@ Function Set-HcxLocation {
} }
} }
Function Get-HcxRoleMapping { Function Get-HcxRoleMapping {
<# <#
.NOTES .NOTES
=========================================================================== ===========================================================================
Created by: William Lam Created by: William Lam
Date: 09/16/2018 Date: 09/16/2018
Organization: VMware Organization: VMware
Blog: http://www.virtuallyghetto.com Blog: http://www.virtuallyghetto.com
Twitter: @lamw Twitter: @lamw
=========================================================================== ===========================================================================
.SYNOPSIS .SYNOPSIS
Returns the System Admin and Enterprise User Group role mappings for HCX Manager Returns the System Admin and Enterprise User Group role mappings for HCX Manager
.DESCRIPTION .DESCRIPTION
This cmdlet returns the System Admin and Enterprise User Group role mappings for HCX Manager This cmdlet returns the System Admin and Enterprise User Group role mappings for HCX Manager
.EXAMPLE .EXAMPLE
Get-HcxRoleMapping Get-HcxRoleMapping
#> #>
If (-Not $global:hcxVAMIConnection) { Write-error "HCX Auth Token not found, please run Connect-HcxVAMI " } Else { If (-Not $global:hcxVAMIConnection) { Write-error "HCX Auth Token not found, please run Connect-HcxVAMI " } Else {
$roleConfigUrl = $global:hcxVAMIConnection.Server + "/api/admin/global/config/roleMappings" $roleConfigUrl = $global:hcxVAMIConnection.Server + "/api/admin/global/config/roleMappings"
if($PSVersionTable.PSEdition -eq "Core") {
$roleRequests = Invoke-WebRequest -Uri $roleConfigUrl -Method GET -Headers $global:hcxVAMIConnection.headers -UseBasicParsing -SkipCertificateCheck
} else {
$roleRequests = Invoke-WebRequest -Uri $roleConfigUrl -Method GET -Headers $global:hcxVAMIConnection.headers -UseBasicParsing
}
($roleRequests.content | ConvertFrom-Json)
}
}
Function Set-HcxRoleMapping {
<#
.NOTES
===========================================================================
Created by: William Lam
Date: 09/16/2018
Organization: VMware
Blog: http://www.virtuallyghetto.com
Twitter: @lamw
===========================================================================
.SYNOPSIS
Configures the System Admin and Enterprise User Group role mappings for HCX Manager
.DESCRIPTION
This cmdlet configures the System Admin and Enterprise User Group role mappings for HCX Manager
.EXAMPLE
Set-HcxRoleMapping -SystemAdminGroup @("DOMAIN\GROUP") -EnterpriseAdminGroup @("DOMAIN\GROUP")
#>
Param (
[Parameter(Mandatory=$True)][String[]]$SystemAdminGroup,
[Parameter(Mandatory=$True)][String[]]$EnterpriseAdminGroup,
[Switch]$Troubleshoot
)
If (-Not $global:hcxVAMIConnection) { Write-error "HCX VAMI Auth Token not found, please run Connect-HcxVAMI " } Else {
$roleConfigUrl = $global:hcxVAMIConnection.Server + "/api/admin/global/config/roleMappings"
$method = "PUT"
$roleConfig = @()
$systemAdminRole = @{
role = "System Administrator";
userGroups = $SystemAdminGroup
}
$enterpriseAdminRole = @{
role = "Enterprise Administrator"
userGroups = $EnterpriseAdminGroup
}
$roleConfig+=$systemAdminRole
$roleConfig+=$enterpriseAdminRole
$body = $roleConfig | ConvertTo-Json -Depth 5
if($Troubleshoot) {
Write-Host -ForegroundColor cyan "`n[DEBUG] - $method`n$locationConfigUrl`n"
Write-Host -ForegroundColor cyan "[DEBUG]`n$body`n"
}
try {
if($PSVersionTable.PSEdition -eq "Core") { if($PSVersionTable.PSEdition -eq "Core") {
$roleRequests = Invoke-WebRequest -Uri $roleConfigUrl -Method GET -Headers $global:hcxVAMIConnection.headers -UseBasicParsing -SkipCertificateCheck $results = Invoke-WebRequest -Uri $roleConfigUrl -Body $body -Method $method -Headers $global:hcxVAMIConnection.headers -UseBasicParsing -SkipCertificateCheck
} else { } else {
$roleRequests = Invoke-WebRequest -Uri $roleConfigUrl -Method GET -Headers $global:hcxVAMIConnection.headers -UseBasicParsing $results = Invoke-WebRequest -Uri $roleConfigUrl -Body $body -Method $method -Headers $global:hcxVAMIConnection.headers -UseBasicParsing
} }
($roleRequests.content | ConvertFrom-Json) } catch {
Write-Host -ForegroundColor Red "`nRequest failed: ($_.Exception)`n"
break
}
if($results.StatusCode -eq 200) {
Write-Host -ForegroundColor Green "Successfully updated vSphere Group Mappings in HCX Manager"
} else {
Write-Error "Failed to update vSphere Group Mappings"
} }
} }
}
Function Set-HcxRoleMapping { Function Get-HcxProxy {
<# <#
.NOTES .NOTES
=========================================================================== ===========================================================================
Created by: William Lam Created by: William Lam
Date: 09/16/2018 Date: 10/31/2018
Organization: VMware Organization: VMware
Blog: http://www.virtuallyghetto.com Blog: http://www.virtuallyghetto.com
Twitter: @lamw Twitter: @lamw
=========================================================================== ===========================================================================
.SYNOPSIS .SYNOPSIS
Configures the System Admin and Enterprise User Group role mappings for HCX Manager Returns the proxy settings for HCX Manager
.DESCRIPTION .DESCRIPTION
This cmdlet configures the System Admin and Enterprise User Group role mappings for HCX Manager This cmdlet returns the proxy settings for HCX Manager
.EXAMPLE .EXAMPLE
Set-HcxRoleMapping -SystemAdminGroup @("DOMAIN\GROUP") -EnterpriseAdminGroup @("DOMAIN\GROUP") Get-HcxProxy
#> #>
Param ( If (-Not $global:hcxVAMIConnection) { Write-error "HCX Auth Token not found, please run Connect-HcxVAMI " } Else {
[Parameter(Mandatory=$True)][String[]]$SystemAdminGroup, $proxyConfigUrl = $global:hcxVAMIConnection.Server + "/api/admin/global/config/proxy"
[Parameter(Mandatory=$True)][String[]]$EnterpriseAdminGroup,
[Switch]$Troubleshoot
)
If (-Not $global:hcxVAMIConnection) { Write-error "HCX VAMI Auth Token not found, please run Connect-HcxVAMI " } Else { if($PSVersionTable.PSEdition -eq "Core") {
$roleConfigUrl = $global:hcxVAMIConnection.Server + "/api/admin/global/config/roleMappings" $proxyRequests = Invoke-WebRequest -Uri $proxyConfigUrl -Method GET -Headers $global:hcxVAMIConnection.headers -UseBasicParsing -SkipCertificateCheck
$method = "PUT" } else {
$proxyRequests = Invoke-WebRequest -Uri $proxyConfigUrl -Method GET -Headers $global:hcxVAMIConnection.headers -UseBasicParsing
}
$proxySettings = ($proxyRequests.content | ConvertFrom-Json).data.items
if($proxyRequests) {
$proxySettings.config
}
}
}
$roleConfig = @() Function Set-HcxProxy {
$systemAdminRole = @{ <#
role = "System Administrator"; .NOTES
userGroups = $SystemAdminGroup ===========================================================================
Created by: William Lam
Date: 10/31/2018
Organization: VMware
Blog: http://www.virtuallyghetto.com
Twitter: @lamw
===========================================================================
.SYNOPSIS
Configure proxy settings on HCX Manager
.DESCRIPTION
This cmdlet configure proxy settings on HCX Manager
.EXAMPLE
Set-HcxProxy -ProxyServer proxy.vmware.com -ProxyPort 3124
.EXAMPLE
Set-HcxProxy -ProxyServer proxy.vmware.com -ProxyPort 3124 -ProxyUser foo -ProxyPassword bar
#>
Param (
[Parameter(Mandatory=$True)]$ProxyServer,
[Parameter(Mandatory=$True)]$ProxyPort,
[Parameter(Mandatory=$False)]$ProxyUser,
[Parameter(Mandatory=$False)]$ProxyPassword,
[Switch]$Troubleshoot
)
If (-Not $global:hcxVAMIConnection) { Write-error "HCX VAMI Auth Token not found, please run Connect-HcxVAMI " } Else {
$proxyConfigUrl = $global:hcxVAMIConnection.Server + "/api/admin/global/config/proxy"
$method = "POST"
if(-not $ProxyUser) { $ProxyUser = ""}
if(-not $ProxyPassword) { $ProxyPassword = ""}
$proxyConfig = @{
config = @{
proxyHost = "$ProxyServer";
proxyPort = "$ProxyPort";
nonProxyHosts = "";
userName = "$ProxyUser";
password = "$ProxyPassword";
} }
$enterpriseAdminRole = @{ }
role = "Enterprise Administrator"
userGroups = $EnterpriseAdminGroup
}
$roleConfig+=$systemAdminRole
$roleConfig+=$enterpriseAdminRole
$body = $roleConfig | ConvertTo-Json -Depth 5 $payload = @{
data = @{
if($Troubleshoot) { items = @($proxyConfig)
Write-Host -ForegroundColor cyan "`n[DEBUG] - $method`n$locationConfigUrl`n"
Write-Host -ForegroundColor cyan "[DEBUG]`n$body`n"
} }
}
$body = $payload | ConvertTo-Json -Depth 5
if($Troubleshoot) {
Write-Host -ForegroundColor cyan "`n[DEBUG] - $method`n$proxyConfigUrl`n"
Write-Host -ForegroundColor cyan "[DEBUG]`n$body`n"
}
try {
if($PSVersionTable.PSEdition -eq "Core") {
$results = Invoke-WebRequest -Uri $proxyConfigUrl -Body $body -Method $method -Headers $global:hcxVAMIConnection.headers -UseBasicParsing -SkipCertificateCheck
} else {
$results = Invoke-WebRequest -Uri $proxyConfigUrl -Body $body -Method $method -Headers $global:hcxVAMIConnection.headers -UseBasicParsing
}
} catch {
Write-Host -ForegroundColor Red "`nRequest failed: ($_.Exception)`n"
break
}
if($results.StatusCode -eq 200) {
Write-Host -ForegroundColor Green "Successfully updated proxy settings in HCX Manager"
if($Troubleshoot) { ($results.Content | ConvertFrom-Json).data.items.config }
} else {
Write-Error "Failed to update proxy settings"
}
}
}
Function Remove-HcxProxy {
<#
.NOTES
===========================================================================
Created by: William Lam
Date: 10/31/2018
Organization: VMware
Blog: http://www.virtuallyghetto.com
Twitter: @lamw
===========================================================================
.SYNOPSIS
Returns the proxy settings for HCX Manager
.DESCRIPTION
This cmdlet returns the proxy settings for HCX Manager
.EXAMPLE
Remove-HcxProxy
#>
If (-Not $global:hcxVAMIConnection) { Write-error "HCX Auth Token not found, please run Connect-HcxVAMI " } Else {
$roleConfigUrl = $global:hcxVAMIConnection.Server + "/api/admin/global/config/proxy"
if($PSVersionTable.PSEdition -eq "Core") {
$proxyRequests = Invoke-WebRequest -Uri $roleConfigUrl -Method GET -Headers $global:hcxVAMIConnection.headers -UseBasicParsing -SkipCertificateCheck
} else {
$proxyRequests = Invoke-WebRequest -Uri $roleConfigUrl -Method GET -Headers $global:hcxVAMIConnection.headers -UseBasicParsing
}
$proxySettings = ($proxyRequests.content | ConvertFrom-Json).data.items
if($proxyRequests) {
$proxyUUID = $proxySettings.config.UUID
$deleteProxyConfigURl = $global:hcxVAMIConnection.Server + "/api/admin/global/config/proxy/$proxyUUID"
$method = "DELETE"
try { try {
if($PSVersionTable.PSEdition -eq "Core") { if($PSVersionTable.PSEdition -eq "Core") {
$results = Invoke-WebRequest -Uri $roleConfigUrl -Body $body -Method $method -Headers $global:hcxVAMIConnection.headers -UseBasicParsing -SkipCertificateCheck $results = Invoke-WebRequest -Uri $deleteProxyConfigURl -Method $method -Headers $global:hcxVAMIConnection.headers -UseBasicParsing -SkipCertificateCheck
} else { } else {
$results = Invoke-WebRequest -Uri $roleConfigUrl -Body $body -Method $method -Headers $global:hcxVAMIConnection.headers -UseBasicParsing $results = Invoke-WebRequest -Uri $deleteProxyConfigURl -Method $method -Headers $global:hcxVAMIConnection.headers -UseBasicParsing
} }
} catch { } catch {
Write-Host -ForegroundColor Red "`nRequest failed: ($_.Exception)`n" Write-Host -ForegroundColor Red "`nRequest failed: ($_.Exception)`n"
@@ -1135,9 +1298,12 @@ Function Get-HcxRoleMapping {
} }
if($results.StatusCode -eq 200) { if($results.StatusCode -eq 200) {
Write-Host -ForegroundColor Green "Successfully updated vSphere Group Mappings in HCX Manager" Write-Host -ForegroundColor Green "Successfully deleted proxy settings in HCX Manager"
} else { } else {
Write-Error "Failed to update vSphere Group Mappings" Write-Error "Failed to delete proxy settings"
} }
} else {
Write-Warning "No proxy settings were configured"
} }
} }
}