Scripts/New-BPAFolder.ps1
|
function New-BPAFolder { <# .SYNOPSIS Creates a new AutoMate BPA folder. .DESCRIPTION New-BPAFolder creates a new folder object. .PARAMETER Name The name of the new folder. .PARAMETER Notes The new notes to set on the object. .PARAMETER Folder The folder to place the object in. .PARAMETER BPAServer The server to create the object on. .EXAMPLE # Create a new folder Get-BPAFolder ParentFolder | New-BPAFolder -Name "FTP Workflows" .NOTES Author(s): : David Seibel Contributor(s) : Date Created : 09/11/2017 Date Modified : 02/12/2018 .LINK https://github.com/davidseibel/PoshBPA #> [CmdletBinding()] param( [Parameter(Mandatory = $true, Position = 0)] [ValidateNotNullOrEmpty()] [string]$Name, [string]$Notes = "", [Parameter(Mandatory = $true)] [ValidateScript({$_.TypeName -eq "Folder"})] $Folder, [string]$BPAServer ) $guid = "{$((New-Guid).Guid)}" if (-not $BPAServer -and $global:BPAConnectionInfo.Count -gt 1) { throw "Multiple BPA Servers are connected, please specify which server to create a new folder on!" } elseif (-not $BPAServer) { $BPAServer = $BPAConnectionInfo.Server } $user = Get-BPAUser -BPAServer $BPAServer | Where-Object {$_.Name -ieq ($BPAConnectionInfo | Where-Object {$_.Server -eq $BPAServer}).Credential.UserName} $newObject = Get-BPAObjectTemplate -Type "Folder " -BPAServer $BPAServer $newObject.ID = $guid $newObject.Name = $Name $newObject.ParentID = $Folder.ID $newObject.Path = Join-Path -Path $Folder.Path -ChildPath $Folder.Name $newObject.CreatedBy = $user.ID $newObject.Notes = $Notes $newObject | New-BPAObject -BPAServer $BPAServer return (Get-BPAFolder -ID $guid -BPAServer $BPAServer) } |