Functions/LDAPDirectories/Add-PASDirectory.ps1
|
function Add-PASDirectory { <# .SYNOPSIS Adds an LDAP directory to the Vault .DESCRIPTION Adds an LDAP directory to the Vault. Membership of the Vault Admins group required. .PARAMETER DirectoryType The name of the directory profile file that the Vault will use when working with the specified LDAP directory. .PARAMETER HostAddresses List of IP addresses of the host servers where the External Directories exist. If the Vault will use an SSL connection to connect to the External Directory, this name must match the subject that appears in the Directory certificate .PARAMETER BindUsername The username of the account used to bind to the directory .PARAMETER BindPassword A SecureString containing the password for the Bind User .PARAMETER DCList Applies to 10.7+; an array of hashtables containing LDAPDomainController information. .PARAMETER Port The port that will be used to access the specified server. The standard port for SSL LDAP connections is 636, and for non-SSL LDAP connections is 389 .PARAMETER DomainName The address of the domain .PARAMETER DomainBaseContext The base context of the External Directory. .PARAMETER SSLConnect Boolean value defining whether or not to connect to the external directory with SSL. .EXAMPLE Add-PASDirectory -DirectoryType "MicrosoftADProfile.ini" -HostAddresses "192.168.60.1","192.168.60.100" -BindUsername "CABind" -BindPassword $pw -Port 389 -DomainName "DOMAIN.COM" -DomainBaseContext "DC=DOMAIN,DC=COM" Adds the Domain.Com directory to the vault .EXAMPLE Add-PASDirectory -DirectoryType "MicrosoftADProfile.ini" -BindUsername "BindUser@domain.com" -BindPassword $($Creds.Password) -DomainName DOMAIN ` -DomainBaseContext "DC=domain,DC=com" -DCList @{"Name"="DC.domain.com";"Port"=636;"SSLConnect"=$true} -SSLConnect $true -Port 636 (For 10.7+) - Adds the Domain.Com directory to the vault, configured for LDAPS. .INPUTS All parameters can be piped to the function by propertyname .OUTPUTS LDAP Directory Details .LINK https://pspas.pspete.dev/commands/Add-PASDirectory #> [System.Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSAvoidUsingPlaintextForPassword', '', Justification = "It's a path to password object")] [CmdletBinding()] param( [parameter( Mandatory = $true, ValueFromPipelinebyPropertyName = $true )] [string]$DirectoryType, [parameter( Mandatory = $true, ValueFromPipelinebyPropertyName = $true, ParameterSetName = "v10_4" )] [string[]]$HostAddresses, [parameter( Mandatory = $false, ValueFromPipelinebyPropertyName = $true )] [string]$BindUsername, [parameter( Mandatory = $false, ValueFromPipelinebyPropertyName = $true )] [securestring]$BindPassword, [parameter( Mandatory = $false, ValueFromPipelinebyPropertyName = $true )] [ValidateRange(1, 65535)] [int]$Port, [parameter( Mandatory = $false, ValueFromPipelinebyPropertyName = $true, ParameterSetName = "v10_7" )] [hashtable[]]$DCList, [parameter( Mandatory = $true, ValueFromPipelinebyPropertyName = $true )] [string]$DomainName, [parameter( Mandatory = $true, ValueFromPipelinebyPropertyName = $true )] [string]$DomainBaseContext, [parameter( Mandatory = $false, ValueFromPipelinebyPropertyName = $true )] [boolean]$SSLConnect ) BEGIN { $MinimumVersion = [System.Version]"10.4" $RequiredVersion = [System.Version]"10.7" }#begin PROCESS { if ($PSCmdlet.ParameterSetName -eq "v10_7") { Assert-VersionRequirement -ExternalVersion $Script:ExternalVersion -RequiredVersion $RequiredVersion } Elseif ($PSCmdlet.ParameterSetName -eq "v10_4") { Assert-VersionRequirement -ExternalVersion $Script:ExternalVersion -RequiredVersion $MinimumVersion } #Create URL for request $URI = "$Script:BaseURI/api/Configuration/LDAP/Directories" #Get request parameters $boundParameters = $PSBoundParameters | Get-PASParameter #deal with BindPassword SecureString If ($PSBoundParameters.ContainsKey("BindPassword")) { #Include decoded bind password in request $boundParameters["BindPassword"] = $(ConvertTo-InsecureString -SecureString $BindPassword) } $body = $boundParameters | ConvertTo-Json #send request to web service $result = Invoke-PASRestMethod -Uri $URI -Method POST -Body $Body -WebSession $Script:WebSession If ($result) { #Return Results $result | Add-ObjectDetail -typename psPAS.CyberArk.Vault.Directory.Extended } }#process END { }#end } |