TestPSRemotingEnabled.psm1
|
# # # TestPSRemotingEnabled - Test PowerShell remoting # # $ErrorActionPreference = 'Stop' # # Module functions # Function Test-PSRemotingEnabled { <# .SYNOPSIS Test if the target computer has PS Remoting enabled .DESCRIPTION Test if the target computer has PS Remoting enabled .PARAMETER ComputerName Name of the target computer .PARAMETER Quiet Use this switch to return only True (PS Remoting enabled) or False (PS Remoting disabled) .EXAMPLE Test-PSRemotingEnabled -ComputerName LabPC2064 .EXAMPLE Test-PSRemotingEnabled -ComputerName LabPC2064 -Quiet .NOTES You must have administrator/domain admin rights or you will get an 'Access denied' error or 'False' if using the Quiet switch .LINK N/A #> [CmdletBinding ()] Param ( [Parameter (Mandatory = $True, ValueFromPipeline = $True, ValueFromPipelineByPropertyName = $True, HelpMessage = 'Enter computer name' ) ] [String[]]$ComputerName, [Switch]$Quiet ) BEGIN { Function Show-Output ($Values) { [PSCustomObject]@{ ComputerName = $Values[0] PSRemotingEnabled = $Values[1] Status = $Values[2] } } } PROCESS { ForEach ($Computer In $ComputerName) { $Result = $False If (Test-Connection -ComputerName $Computer -Count 1 -Quiet) { If ($Quiet) { [Bool](Invoke-Command -ComputerName $Computer -ScriptBlock {Write-Output 'Ok'} -ErrorAction SilentlyContinue) } Else { Try { $Result = [Bool](Invoke-Command -ComputerName $Computer -ScriptBlock {Write-Output 'Ok'}) Show-Output ($Computer.toUpper(), $Result, 'Ok') } Catch { Show-Output ($Computer.toUpper(), $Result, $PSItem.Exception.Message) } } } Else { If ($Quiet) { Write-Output 'Unreachable' } Else { Show-Output ($Computer.toUpper(), '', 'Unreachable') } } } } END {} } |