Public/New-WinSCPSessionOption.ps1
|
function New-WinSCPSessionOption { [CmdletBinding( ConfirmImpact = "Low", HelpUri = "https://github.com/dotps1/WinSCP/wiki/New-WinSCPSessionOption", PositionalBinding = $false, SupportsShouldProcess = $true )] [OutputType( [WinSCP.SessionOptions] )] param ( [Parameter()] [ValidateNotNull()] [PSCredential] $Credential = [PSCredential]::new( "anonymous", [SecureString]::new() ), [Parameter()] [WinSCP.FtpMode] $FtpMode = (New-Object -TypeName WinSCP.FtpMode), [Parameter()] [WinSCP.FtpSecure] $FtpSecure = (New-Object -TypeName WinSCP.FtpSecure), [Parameter()] [Switch] $GiveUpSecurityAndAcceptAnySshHostKey, [Parameter()] [Switch] $GiveUpSecurityAndAcceptAnyTlsHostCertificate, [Parameter( Mandatory = $true )] [Alias( "ComputerName" )] [String] $HostName, [Parameter()] [Int] $PortNumber = 0, [Parameter()] [WinSCP.Protocol] $Protocol = ( New-Object -TypeName WinSCP.Protocol ), [Parameter()] [SecureString] $SecurePrivateKeyPassphrase, [Parameter( ValueFromPipelineByPropertyName = $true )] [String[]] $SshHostKeyFingerprint, [Parameter()] [ValidateScript({ if (Test-Path -Path $_) { if ((Get-Item -Path $_).PSIsContainer) { throw "Target is not a file: '$_'." } else { return $true } } else { throw "Unable to find part of Path: '$_'." } })] [String] $SshPrivateKeyPath, [Parameter()] [ValidateScript({ if (Test-Path -Path $_) { if ((Get-Item -Path $_).PSIsContainer) { throw "Target is not a file: '$_'." } else { return $true } } else { throw "Unable to find part of Path: '$_'." } })] [String] $TlsClientCertificatePath, [Parameter()] [String] $TlsHostCertificateFingerprint, [Parameter()] [TimeSpan] $Timeout = (New-TimeSpan -Seconds 15), [Parameter()] [Switch] $WebdavSecure, [Parameter()] [String] $RootPath, [Parameter()] [HashTable] $RawSetting ) begin { $sessionOptions = New-Object -TypeName WinSCP.SessionOptions } process { $shouldProcess = $PSCmdlet.ShouldProcess( $sessionOptions ) if ($shouldProcess) { # Convert PSCredential Object to match names of the WinSCP.SessionOptions Object. # Remove the parameter "Credential", that is not a valid property of the WinSCP.SessionObject. $PSBoundParameters.Add( "UserName", $Credential.UserName ) $PSBoundParameters.Add( "SecurePassword", $Credential.Password ) # Resolve Full Path, WinSCP.exe does not like dot sourced path for the Certificate. $sshPrivateKeyPathUsed = $PSBoundParameters.ContainsKey( "SshPrivateKeyPath" ) if ($sshPrivateKeyPathUsed) { $PSBoundParameters.SshPrivateKeyPath = Resolve-Path -Path $SshPrivateKeyPath | Select-Object -ExpandProperty ProviderPath } $tlsClientCertificatePathUsed = $PSBoundParameters.ContainsKey( "TlsClientCertificatePath" ) if ($tlsClientCertificatePathUsed) { $PSBoundParameters.TlsClientCertificatePath = Resolve-Path -Path $TlsClientCertificatePath | Select-Object -ExpandProperty ProviderPath } # Enumerate each parameter. try { $sessionOptionObjectProperties = $sessionOptions | Get-Member -MemberType Property | Select-Object -ExpandProperty Name $keys = ($PSBoundParameters.Keys).Where({ $_ -in $sessionOptionObjectProperties }) foreach ($key in $keys) { $sessionOptions.$key = $PSBoundParameters.$key } } catch { $PSCmdlet.ThrowTerminatingError( $_ ) } # Enumerate raw settings and add the options to the WinSCP.SessionOptions object. foreach ($key in $RawSetting.Keys) { $sessionOptions.AddRawSettings( $key, $RawSetting[$key] ) } Write-Output -InputObject $sessionOptions } } } |