Functions/CSP/Portal/New-B1Host.ps1
|
function New-B1Host { <# .SYNOPSIS Creates a new NIOS-X Host .DESCRIPTION This function is used to create a new NIOS-X Host .PARAMETER Name The name of the NIOS-X Host to create .PARAMETER Space The IPAM space where the NIOS-X Host should be placed .PARAMETER Description The description of the new NIOS-X Host .PARAMETER Location The Location for the new NIOS-X Host. .PARAMETER Force Perform the operation without prompting for confirmation. By default, this function will not prompt for confirmation unless $ConfirmPreference is set to Medium. .EXAMPLE PS> New-B1Host -Name "ddihost1.mydomain.corp" -Description "My NIOS-X Host" -Space "Global" .FUNCTIONALITY NIOS-X #> [CmdletBinding( SupportsShouldProcess, ConfirmImpact = 'Medium' )] param( [Parameter(Mandatory=$true)] [String]$Name, [Parameter(Mandatory=$true)] [String]$Space, [String]$Location, [String]$Description, [Switch]$Force ) $ConfirmPreference = Confirm-ShouldProcess $PSBoundParameters if (Get-B1Host -Name $Name -Strict) { Write-Host "$Name already exists as an On-Prem host." -ForegroundColor Red break } $splat = @{ "display_name" = $Name "ip_space" = (Get-B1Space -Name $Space -Strict).id "description" = $Description } if ($Location) { $LocationID = (Get-B1Location -Name $Location -Strict).id if ($LocationID) { $splat.location_id = $LocationID } else { Write-Error "Unable to find Location: $($Location)" return $null } } $JSON = $splat | ConvertTo-Json if($PSCmdlet.ShouldProcess("Create new NIOS-X Host:`n$($JSON)","Create new NIOS-X Host",$MyInvocation.MyCommand)){ $Result = Invoke-CSP -Method POST -Uri "$(Get-B1CSPUrl)/api/infra/v1/hosts" -Data $JSON | Select-Object -ExpandProperty result -ErrorAction SilentlyContinue $Result if ($Result.display_name -eq $Name) { Write-Host "On-Prem host $Name created successfully." -ForegroundColor Green } else { Write-Host "Failed to create On-Prem host $Name." -ForegroundColor Red } } } |