Supporting custm -Port parameter when using PSRemoting (WinRM)

[ClaudioESSilva]

Type of Change

• Bug fix (non-breaking change, fixes # )
• New feature (non-breaking change, adds functionality, fixes dbatools cannot connect to WinRM over custom port #8480 )
• Breaking change (effects multiple commands or functionality, fixes # )
• Ran manual Pester test and has passed (.\tests\manual.pester.ps1)
• Adding code coverage to existing functionality
• Pester test is included
• If new file reference added for test, has is been added to github.com/dataplat/appveyor-lab ?
• Unit test is included
• Documentation
• Build system

Purpose

Support a custom port when using PSRemoting

Approach

Made it configurable through Set-DbatoolsConfig.
Then it will be read when creating the parameter list to connect.

NOTE: Similar to the -UseSSL configuration.

Commands to test

Users need to set the wanted value for the port using Set-DbatoolsConfig command

Set-DbatoolsConfig -FullName 'PSRemoting.PsSession.Port' -Value 1111

Call any command that uses PSRemoting (WinRM)

To reset it (also on the notes) use:

Set-DbatoolsConfig -FullName 'PSRemoting.PsSession.Port' -Value $null

[potatoqualitee]

Solid changes, thank you so very much! Will approve once tests pass (There have been a couple legitimate failures so far)

[potatoqualitee]

just one more test to pass until merge! 😊

[potatoqualitee]

gorrrge, thanks @ClaudioESSilva !