PowerShell: Test-Host


       
       .Synopsis
            Test to see if this host is online and accessible.
       
        .Description
            Sends two pings the the hostname, then attempts to access the admin share for this host.
       
        .Parameter HostName
            Hostname or IP address to be tested.
       
        .Parameter skipPingTest
            This will allow you to skip the ping test when validating a host is up.
       
        .Parameter skipShareTest
            This will allow you to skip the share test when validating a host is up.
       
        .Example
            Test-Host DanielPC
            Description
            ———–
            Tests the host with both two pings and an admin share connection test.
           
        .Example
            Test-Host DanielPC -p
            Test-Host DanielPC -skipPingTest
            Description
            ———–
            Tests the host by admin share test and skips the ping test…
       
        .Example
            Test-Host DanielPC -s
            Test-Host DanielPC -skipShareTest
            Description
            ———–
            Tests the host by ping test only and skips the admin share test…
           
        .Example
            "DanielPC " | Test-Host
            Description
            ———–
            Receives input from the pipeline for testing if a host is online or not.
           
        .OUTPUTS
            Boolean
       
        .NOTES
            NAME:       Test-Host
            AUTHOR:     Daniel Moran
            Website:    http://www.moranit.com
            LASTEDIT:   04/18/2011
            #Requires   -Version 2.0
       
        .LINK
            https://danielheth.com/2011/04/18/powershell-test-host/

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s