public/New-TNLdapServer.ps1
|
function New-TNLdapServer { <# .SYNOPSIS Creates new ldap servers .DESCRIPTION Creates new ldap servers .PARAMETER SessionObject Optional parameter to force using specific SessionObjects. By default, each command will connect to all connected servers that have been connected to using Connect-TNServer .PARAMETER Name The name of the target ldap server .PARAMETER ComputerName The network name or IP address of the Nessus or tenable.sc server .PARAMETER Credential The credential object (from Get-Credential) used to log into the target server. Specifies a user account that has permission to send the request. .PARAMETER Port The port of the Nessus or tenable.sc server. Defaults to 8834 which is the default port for Nessus. .PARAMETER BaseDN Description for BaseDN .PARAMETER Encryption Description for Encryption .PARAMETER UserObjectFilter Description for UserObjectFilter .PARAMETER SeachString Description for SeachString .PARAMETER TimeLimit Description for TimeLimit .PARAMETER EnableException By default, when something goes wrong we try to catch it, interpret it and give you a friendly warning message. This avoids overwhelming you with 'sea of red' exceptions, but is inconvenient because it basically disables advanced scripting. Using this switch turns this 'nice by default' feature off and enables you to catch exceptions with your own try/catch. .EXAMPLE PS C:\> $params = @{ Name = "DC" ComputerName = "dc" Credential = $adcred BaseDN = "DC=ad,DC=local" } PS C:\> New-TNLdapServer @params -Verbose Creates a new ldap server for the ad.loacl domain, which connects to the domain controller named "DC" #> [CmdletBinding()] param ( [Parameter(ValueFromPipelineByPropertyName)] [object[]]$SessionObject = (Get-TNSession), [Parameter(ValueFromPipelineByPropertyName, Mandatory)] [string]$Name, [Parameter(ValueFromPipelineByPropertyName, Mandatory)] [string]$ComputerName, [Parameter(ValueFromPipelineByPropertyName)] [pscredential]$Credential, [Parameter(ValueFromPipelineByPropertyName)] [int]$Port = 389, [Parameter(ValueFromPipelineByPropertyName, Mandatory)] [string]$BaseDN, [Parameter(ValueFromPipelineByPropertyName)] [ValidateSet("ldaps", "none", "tls")] [string]$Encryption = "tls", [string]$UserObjectFilter, [string]$SeachString, [int]$TimeLimit = 3600, [switch]$EnableException ) process { foreach ($session in $SessionObject) { $PSDefaultParameterValues["*:SessionObject"] = $session if (-not $session.sc) { Stop-PSFFunction -EnableException:$EnableException -Message "Only tenable.sc supported" -Continue } $body = @{ name = $Name description = $Description host = $ComputerName port = $Port encryption = $Encryption.ToLower() dn = $BaseDN dnsField = "dNSHostName" timeLimit = $TimeLimit searchString = $SearchString } if ($PSBoundParameters.Credential) { $body.Add("username", $Credential.UserName) $body.Add("password", ($Credential.GetNetworkCredential().Password)) } $params = @{ SessionObject = $session Path = "/ldap" Method = "POST" Parameter = $body EnableException = $EnableException } Invoke-TNRequest @params | ConvertFrom-TNRestResponse } } } |