Powershell connector configuration
Connector attributes
argumentStyle
Powershell connector calls powershell command and passes mapped attributes to it. There are four different ways of passing an argument to powershell script and they all correspond with possible configuration values below.
- PARAMETERS_DASH - Executes command in this template: COMMAND -PARAMETER_NAME VALUE
- PARAMETERS_SLASH - Executes command in this template: COMMAND /PARAMETER_NAME:VALUE
- VARIABLES - Executes command in this template: $PARAMETER_NAME=VALUE COMMAND
- HASH_MAP - This template exists only because powershell has problems passing multiple parameters to longer script blocks. It creates map as one input argument which will then contain all input parameters.
testScriptPath, authenticateScriptPath, searchScriptPath, deleteScriptPath, createScriptPath, updateScriptPath, syncScriptPath
These parameters contain path to scripts (on client machine) which will be executed when corresponding operation is invoked. Make sure that the script files are accessible.
useScriptCache
If true, then scripts, once read from drive, will be kept in memory for later reuse.
userName
Username used for authentication.
disableableCertificateChecks
If true, then connector will not check certificate validity.
script ResponseType
Only CSV is supported at the moment.
authenticationScheme
Specifies type of authentication to use. Possible values are:
- Basic
- NTLM
- Negotiate
- Kerberos
- CredSSP
endpointUri
Uri contains information about protocol, port and hostname. Common URIs are
- http://HOST:5985/wsman for http communication
- https://HOST:5986/wsman for https comunication
domainName
Name of AD domain. It is used for authentication purposes.
multivaluedArgumentEncodingStrategy, multivalueEncodingSeparator
This is used for encoding multivalued parameters as arguments. Possible values are:
- SINGLE_VALUE_ONLY - Uses only one value
- MULTIVALUE_WITH_SEPARATOR - encodes multivalue as list of values separated by multivalueEncodingSeparator
- MULTIVALUE - encodes multivalue using Java Arrays.toString method
Setting-up WinRM
MS Exchange
In order to use Powershell commands such as New-Mailbox, you need to add Exchange snapIn. Example powershell create script can be seen bellow.
param([string]$__UID__ = "", [string]$__NAME__ = "",[string]$SamAccountName = "", [string]$name = "", [string]$UserPrincipalName = "", [string]$__PASSWORD__) Try{ Add-PSSnapIn -Name Microsoft.Exchange.Management.PowerShell.SnapIn $secure_password = ConvertTo-SecureString -String $__PASSWORD__ -AsPlainText -Force New-Mailbox ` -SamAccountName $SamAccountName ` -Name $name ` -UserPrincipalName $UserPrincipalName ` -Password $secure_password ` -Confirm:$false ` -ErrorAction Stop | out-null -outvariable $mailbox Write-Host "__UID__,__NAME__" Write-Host "$SamAccountName,$SamAccountName" } Catch { Write-Host "__ERROR__" Write-Host "$_.Exception.Message" }
Another requirement is top use CredSSP authentication scheme.