Josh Erickson

Oooo! Version 0.2 of netview.ps1! Some code changes and less dieing in the middle of a listing! Also included is a -IsCluster switch! It’s great for easily finding out if a given NetBIOS name is a machine or a cluster!

<#
.Synopsis
Parses the "net view" command into PowerShell objects for easy usage.
.description
Switches and parameters are copied stright from "Net view".

Return objects are named after the output table headers in net view.

NETVIEW.PS1 displays a list of resources being shared on a computer. When used without options, it displays a list of computers in the current domain or network.
.parameter Computer
    Is a computer whose shared resources you want to view.
.parameter Domain
    Specifies the domain for which you want to view the available computers. If domainname is omitted, displays all domains in the local area network.
.parameter Cache
    Displays the offline client caching settings for the resources on the specified computer
.parameter All
    Displays all the shares including the $ shares
.parameter ResolveIP
    Resolves the NetBIOS names to their network IP addresses.
.parameter GetOS
    Uses CIM_OperatingSystem WMI class to obtain the operating system.
.parameter GetUser
    Get's the last user who logged in to that machine.
.parameter IsCluster
    Tries to find out if the ServerName is a cluster name.
.parameter Credentials
    Optional credentials to use for GetOS. If none are supplied it tries to use current credentials.
.Notes
-Version 0.2
    *Made some code changes so it doesn't die after WMI query failure.
    *Added missing .parameters as well as .Link and .Note.
    *Added IsCluster switch which checks to see if WINS is a cluster name instead of a machine name.
.Link

http://josherickson.org/tag/netview-ps1

#>
param (
    [string]$Computer,
    [string]$Domain,
    [switch]$Cache,
    [switch]$All,
	[switch]$ResolveIP,
    [switch]$GetOS,
    [switch]$GetUser,
    [switch]$IsCluster,
    [System.Management.Automation.PSCredential]$Credentials
)

#Take some notes and clean up stuff.
if($Computer.length -gt 1 -and !$Computer.startswith("\\")) {
    $Computer = "\\$computer";
    #$computer = "/computer $computer";
}
if($Domain.length -gt 1) {
    $Domain = "/DOMAIN:$Domain";
}

if($Cache.ispresent) {
    $_Cache = "/CACHE";
}

if($All.ispresent) {
    $_All = "/ALL";
}
try {
    $nv_raw = (powershell "& { net view $Computer $_Cache $_All $Domain }" 2>&1)
    if(($nv_raw | where {$_.tolower().contains("error")})) { throw $nv_raw; }
} catch{
    $nv_raw | where {$_} | Write-Error;
    exit;
}
#If computer isn't defined, we just want to parse the net view output as a list of computers.
if($Computer.length -eq 0) {
	$nv = $nv_raw | where {$_.startswith("\\")} | foreach { @{"name" = $_.substring(2,$_.indexof(" ")-2).replace(" ",""); "remark" = [regex]::Split($_, "( ){2,}")[2]} }
	foreach($a in $nv) {
		try {
			$r = new-object object;

			Add-Member -InputObject $r -MemberType NoteProperty -Name "ServerName" -Value $a.name;
			Add-Member -InputObject $r -MemberType NoteProperty -Name "Remarks" -Value $a.remark;

			[string]::Format("Running computer: {0}", $r.ServerName) | Write-Debug;

			if($GetIP.IsPresent) {
				try {
					Add-Member -InputObject $r -MemberType NoteProperty -Name "AddressList" -Value ([net.dns]::GetHostEntry($r.ServerName).addresslist);
				}
				catch {}
			}

			Add-Member -InputObject $r -MemberType ScriptMethod -Force -Name "ToString" -Value {
				try {
					return $this.ServerName +"|"+ [string]::Join("|", ($this.Addresslist));
				}
				catch{
					return $this.ServerName;
				}
			}

			if($GetOS.ispresent) {
				$__error = $Null;
				try {
					#if this computer is the one we're currently working on we can't use the gwmi credentials parameter
					if($r.ServerName -ne (hostname) -and $Credentials) {
						$os_cap = (gwmi -Class CIM_OperatingSystem -ComputerName $r.ServerName -Credential $Credentials).caption 2> $__error;
					} else {
						$os_cap = (gwmi -Class CIM_OperatingSystem -ComputerName $r.ServerName).caption  2> $__error;
					}
					if($__error) { throw $__error; }
					Add-Member -InputObject $r -MemberType NoteProperty -Name "OS" -Value $os_cap;
				} catch {
					$Error | Write-Error;
				}
			}

			if($GetUser.ispresent) {
				try {
					#if this computer is the one we're currently working on we can't use the gwmi credentials parameter
					if($r.ServerName -ne (hostname)) {
						$loggedon_user = (gwmi -Class CIM_UnitaryComputerSystem -ComputerName $r.ServerName -Credential $Credentials).UserName 2> $__error;
					} else {
						$loggedon_user = (gwmi -Class CIM_UnitaryComputerSystem -ComputerName $r.ServerName).UserName 2> $__error;
					}
					if($__error) { throw $__error; }
					Add-Member -InputObject $r -MemberType NoteProperty -Name "LastLoggedOnUser" -Value $loggedon_user;
				} catch {
					$Error | Write-Error;
				}
			}

			if($IsCluster.ispresent -xor ($IsCluster.ispresent -and $r.os -and !$r.os.contains("Server"))) {
				Add-Member -InputObject $r -MemberType NoteProperty -Name "IsCluster" -Value $False;
				try {
					if($Credentials) {
						$c = (gwmi -ComputerName $r.servername -Namespace Root\MSCluster -Class MSCluster_Node -ErrorAction "SilentlyContinue" -Credential $Credentials)

					} else {
						$c = (gwmi -ComputerName $r.servername -Namespace Root\MSCluster -Class MSCluster_Node -ErrorAction "SilentlyContinue")
					}

					$r.IsCluster = ([int]$c.length -gt 0 -and !(($c | foreach {$_.name}) -contains $r.servername));
				} catch {
					$Error | Write-Error;
				}
			}
			#output the object.
			$r;
		} catch {}
	}
} else { #Parse shares list
	#Start of lines that we DON'T want.
	$lines = @("Shared resources at", "Share name", "-----------", "The command completed successfully.");

	foreach($l in $nv_raw) {
		if(($lines | where {$l.startswith($_);}) -eq $null -and $l.length -gt 0) {
		   $r = New-Object object;
		   $t = [regex]::Split($l, "( ){2,}") | where {$_.replace(" ","").length -gt 0};
		   Add-Member -InputObject $r -MemberType NoteProperty -Name "Name" -Value $t[0];
		   Add-Member -InputObject $r -MemberType NoteProperty -Name "Type" -Value $t[1];
		   Add-Member -InputObject $r -MemberType ScriptProperty -Name "Secret" -Value {
				$this.ShareName.EndsWith("$");
		   }
		   if($t.length -gt 3) {
			   Add-Member -InputObject $r -MemberType NoteProperty -Name "UsedAs" -Value $t[2];
			   Add-Member -InputObject $r -MemberType NoteProperty -Name "Comment" -Value $t[3];
		   } else {
			   Add-Member -InputObject $r -MemberType NoteProperty -Name "Comment" -Value $t[2];
		   }
		   $r;
		}
	}
}