Public/Set-PaTag.ps1
|
function Set-PaTag { <# .SYNOPSIS Creates/Configures an Tag object on a Palo Alto device. .DESCRIPTION Creates/Configures an Tag object on a Palo Alto device. .EXAMPLE .PARAMETER Name #> [CmdletBinding(SupportsShouldProcess=$True)] Param ( [Parameter(Mandatory=$True,Position=0)] [string]$Name, [Parameter(Mandatory=$False,Position=1)] [ValidateSet('Red','Green','Blue','Yellow','Copper','Orange','Purple','Gray','Light Green','Cyan','Light Gray','Blue Gray','Lime','Black','Gold','Brown','Green')] [string]$Color, [Parameter(Mandatory=$False,Position=2)] [string]$Comments ) BEGIN { $ConfigNode = 'tag' $Xpath = $Global:PaDeviceObject.createXPath($ConfigNode,$Name) } PROCESS { if ($Color) { $ConfigObject = [PaTag]::new($Name,$Color) $global:configobject = $ConfigObject } else { $ConfigObject = [PaTag]::new($Name) } $ConfigObject.Comments = $Comments $ElementXml = $ConfigObject.ToXml().$ConfigNode.entry.InnerXml if ($PSCmdlet.ShouldProcess("Creating new Tag: $($ConfigObject.Name)")) { $Set = Invoke-PaApiConfig -Set -Xpath $XPath -Element $ElementXml $Set } } } |