Public/Add-PoolMember.ps1
|
Function Add-PoolMember{ <# .SYNOPSIS Add a computer to a pool as a member .LINK [Modifying pool members](https://devcentral.f5.com/questions/modifying-pool-members-through-rest-api) [Add a pool with an existing node member](https://devcentral.f5.com/questions/add-a-new-pool-with-an-existing-node) #> [cmdletBinding()] param ( $F5Session=$Script:F5Session, [Parameter(Mandatory=$true,ParameterSetName='InputObject',ValueFromPipeline=$true)] [Alias("Pool")] [PSObject[]]$InputObject, [Parameter(Mandatory=$true,ParameterSetName='PoolName',ValueFromPipeline=$true)] [string[]]$PoolName, [Parameter(Mandatory=$false,ValueFromPipelineByPropertyName=$true)] [string]$Partition, [Parameter(Mandatory=$false)] [PoshLTM.F5Address]$Address=[PoshLTM.F5Address]::Any, [Parameter(Mandatory=$false)] [string]$Name, [Parameter(Mandatory=$true)] [ValidateRange(0,65535)] [int]$PortNumber, [Parameter(Mandatory=$false)] [string]$Description, [ValidateSet("Enabled","Disabled")] [Parameter(Mandatory=$true)]$Status, [Alias('iApp')] [Parameter(Mandatory=$false,ValueFromPipelineByPropertyName=$true)] [string]$Application='', [Parameter(Mandatory=$false)] [int]$RouteDomain ) begin { #Test that the F5 session is in a valid format Test-F5Session($F5Session) #If both Address and RouteDomain are passed in, then append RouteDomain to Address if ($Address -and $RouteDomain) { $Address = "{0}%{1}" -f $Address.IPAddress.IPAddressToString, $RouteDomain.ToString() } If (!$Name -and !$Address){ Write-Error 'Either a name or an IP address is required.' } #Strip out any port info when checking for an existing node $NodeName = $Name -replace ':\d+$','' $ExistingNode = Get-Node -F5Session $F5Session -Address $Address -Name $NodeName -Partition $Partition -ErrorAction SilentlyContinue } process { switch ($PSCmdLet.ParameterSetName) { 'InputObject' { switch ($InputObject.kind) { "tm:ltm:pool:poolstate" { $AddressString = $Address.ToString() if ($Address -ne [PoshLTM.F5Address]::Any) { # Default name to IPAddress if (!$Name) { $Name = '{0}:{1}' -f $AddressString, $PortNumber } } # Append port number if not already present if ($Name -notmatch ':\d+$') { $Name = '{0}:{1}' -f $Name,$PortNumber } foreach($pool in $InputObject) { if (!$Partition) { $Partition = $pool.partition } $JSONBody = @{name=$Name;partition=$Partition;address=$AddressString;description=$Description} if ($ExistingNode) { # Node exists, just add using name $JSONBody = @{name=('{0}:{1}' -f $ExistingNode.name,$PortNumber);partition=('{0}' -f $Partition);description=$Description} } # else the node will be created $JSONBody = $JSONBody | ConvertTo-Json $MembersLink = $F5session.GetLink($pool.membersReference.link) Invoke-F5RestMethod -Method POST -Uri "$MembersLink" -F5Session $F5Session -Body $JSONBody -ContentType 'application/json' -ErrorMessage "Failed to add $Name to $($pool.name)." | Add-ObjectDetail -TypeName 'PoshLTM.PoolMember' #After adding to the pool, make sure the member status is set as specified If ($Status -eq "Enabled"){ $pool | Get-PoolMember -F5Session $F5Session -Address $AddressString -Name $Name -Application $Application | Enable-PoolMember -F5session $F5Session | Out-Null } ElseIf ($Status -eq "Disabled"){ $pool | Get-PoolMember -F5Session $F5Session -Address $AddressString -Name $Name -Application $Application | Disable-PoolMember -F5session $F5Session | Out-Null } } } } } 'PoolName' { foreach($pName in $PoolName) { Get-Pool -F5Session $F5Session -PoolName $pName -Partition $Partition -Application $Application | Add-PoolMember -F5session $F5Session -Address $Address -Name $Name -Description $Description -PortNumber $PortNumber -Status $Status -Application $Application } } } } } |