Skip to main content

Get User connections to a share

I have always put this one in the "I'll get round to it" pile.  Today, I have finally got round to it!

You can quite easily determine who is connected to a Windows Server by going to Computer Manager and choosing shared folders - sessions.  You can also see how many people are connected to a share by going to Computer Manager and choosing shared folders - shares.  What i want to know is WHO is connected to each share.  I have had quite a big reason to do this recently and so I have finally got round to creating a powershell 2 function to do precicely that!

It will accept 2 parameters, a servername and an optional sharename to return only the connections from a particular share. 



function get-shareConnection {
#generate the help file
<# .SYNOPSIS Get the current users that are connected to shares on a server .DESCRIPTION Get the current users that are connected to shares on a server. This can be filtered to a specific share. .NOTES Function Name : get-shareConnection Author : Adam Stone Requires : PowerShell V2 .LINK .EXAMPLE Simple usage - get all connections for all shares on server1 PS C:\> get-shareConnection -server Server1
Simple usage - get all connections for the users share on server1
PS C:\> get-shareConnection -server Server1 -sharename users
Simple usage - get all connections for the users share on server1 (using positional parameters)
PS C:\>; get-shareConnection Server1 users
The servername to connect to.
.PARAMETER sharename
optional sharename to return users connected to this share

#parameter validataion
param (
[Parameter(Position=0, Mandatory=$true,HelpMessage="Please enter a server name")]
[string] $Server = ""
[string] $sharename = "all"
#the processes the function will complete
process {
$serverconnection = Get-WmiObject -ComputerName $Server -Class Win32_SessionConnection

$users = @()
foreach ($connection in $serverconnection){
$conn = "" | select "ip","user","share"
$split = $connection.Dependent.split(",")
$conn.ip = $split[0].replace("Win32_ServerConnection.computername=","").replace('"','')
$conn.user = $split[2].replace("UserName=","").replace('"','')
$conn.share = $split[1].replace("sharename=","").replace('"','')
if ($sharename -eq "all"){$users += $conn}
else{if ($conn.share -eq $sharename){$users += $conn}}
return $users

}#end function


Popular posts from this blog

PowerShell 3 behavioural change

It's taken me way too long to get into PowerShell 3, I guess opportunity hasn't shown it's self until now and so, here, my V3 journey begins.

I was asked to debug a script that would run fine in PS v2 and not in v3.  The issue was a that a variable length was being checked and was failing in v3.  This is why...

In v2 if a variable is undefined, this test returns false

PS C:\windows\system32> $var.length -eq 0

In v3 the same test returns true....

PS C:\windows\system32> $var.length -eq 0

Not a biggie, but as in this case, a script has broken so something to consider!



Enable Powershell Remoting (WinRM) via Group Policy

I have been doing some testing on enabling WinRM via group policy, being that WinRM is the service that Powershell v2 sets up it remoting capabilities. Here are the GPO settings that you need to configure WinRM ....

set the winrm service to auto start

Computer Configuration \ Policies \ Windows Settings \ Security Settings \ System Services

Windows Remote Management (WS-Management)  set Startup Mode to Automatic

start the service

incorporated in to the above - you may need a restart.

create a winrm listener

Computer Configuration / Policies / Administrative Templates / Windows Components / Windows Remote Management (WinRM) / WinRM Service / Allow automatic configuration of listeners

IPv4 filter: *

* is listen on all addresses, or if you only want a particular IP address to respond use an iprange eg - don't forget that this IP range has to be valid for all hosts that fall in the scope of the GPO you are creating.  You can use -, - …

compare-object in Powershell - comparing mulitple values

I'm starting to use compare-object more and more, and one thing I noticed, is that you can compare 2 objects based on multiple attributes. here is how it is constructed...
Compare-Object -ReferenceObject $object1 -DifferenceObject $object2 -Property a,b,c,d,eIf a,b,c and d are the same, but e is different, compare object will return a difference. In the following example, I use "-eq $null" as a check because by default compare-object returns $null if the objects are the same.
#create an array of objects to check against

$collection = @()
foreach ($entry in ("aaaaa","bbbbb","ccccc","ddddd")){
   $store = "" | select "a","b","c","d","e"
   $store.a = $entry*1
   $store.b = $entry*2
   $store.c = $entry*3
   $store.d = $entry*4
   $store.e = $entry*5
   $collection += $store

#create an object similar to those in the array
$object = "" | select "a","b…