Get-SmbSharePermission.ps1
|
<#PSScriptInfo
.VERSION 1.0.0 .GUID 7ba4bd6b-a75a-5229-9671-298d7d669a37 .AUTHOR Torsten Weise .COMPANYNAME powerscripting.de .COPYRIGHT (c) 2026 Torsten Weise. MIT-Lizenz. .TAGS Powerscripting German Security Hardening Windows Audit PSEdition_Desktop PSEdition_Core .LICENSEURI https://powerscripting.de/skripte/files/LICENSE.txt .PROJECTURI https://powerscripting.de/skripte/get-smbsharepermission.html .ICONURI https://powerscripting.de/assets/icon-192.png .EXTERNALMODULEDEPENDENCIES .REQUIREDSCRIPTS .EXTERNALSCRIPTDEPENDENCIES .RELEASENOTES Erste Veröffentlichung in der PowerShell Gallery. .PRIVATEDATA #> <# .SYNOPSIS Listet alle Freigaben auf Dateiservern mit Freigabe- und NTFS-Rechten und markiert zu weit offene Freigaben. .DESCRIPTION Liest per PowerShell-Remoting auf jedem Server die SMB-Freigaben aus. Für jede Freigabe kommen zwei Ebenen in den Bericht: 1. Die Freigaberechte (Get-SmbShareAccess). 2. Die NTFS-Rechte auf dem Stammordner der Freigabe (Get-Acl), ohne die Unterordner. Wirksam ist immer die strengere der beiden Ebenen. Steht auf der Freigabe "Jeder: Vollzugriff", entscheidet allein NTFS. Das ist üblich, aber nur in Ordnung, wenn NTFS sauber gesetzt ist. Als "Prüfen" markiert werden breite Gruppen (Jeder, Authentifizierte Benutzer, Benutzer, Domänen-Benutzer) mit Schreib- oder Vollzugriff auf NTFS-Ebene. Genau das sind die Freigaben, die Ransomware von einem einzigen befallenen Client aus verschlüsseln kann. Administrative Freigaben (C$, ADMIN$, IPC$) werden ausgelassen. Ergänzend zu Find-FolderPermission, das von einem Benutzer ausgeht, geht dieses Skript von den Freigaben aus. .PARAMETER ComputerName Dateiserver, deren Freigaben geprüft werden. Standard: der eigene Rechner. .PARAMETER IncludeHidden Auch versteckte Freigaben (Name endet auf $) einbeziehen, außer den administrativen. .PARAMETER BroadGroup Gruppen, die als zu breit gelten. Platzhalter sind erlaubt. Standard: Jeder, Authentifizierte Benutzer, Benutzer und Domänen-Benutzer in Deutsch und Englisch. .PARAMETER ReportPath Ordner für HTML- und CSV-Bericht. Standard: aktueller Ordner. .EXAMPLE .\Get-SmbSharePermission.ps1 -ComputerName FS01, FS02 Bericht über alle Freigaben auf zwei Dateiservern. .EXAMPLE .\Get-SmbSharePermission.ps1 -ComputerName FS01 | Where-Object Bewertung -eq 'Prüfen' Gibt nur die auffälligen Einträge als Objekte aus, z. B. zum Weiterverarbeiten. .NOTES Autor: Torsten Weise, powerscripting.de Benötigt Windows Server 2012 oder neuer auf den Zielsystemen (SmbShare-Modul). Das Skript liest nur. #> [CmdletBinding()] param( [string[]] $ComputerName = @($env:COMPUTERNAME), [switch] $IncludeHidden, [string[]] $BroadGroup = @('Jeder', 'Everyone', '*\Authentifizierte Benutzer', '*\Authenticated Users', '*\Benutzer', '*\Users', '*\Domänen-Benutzer', '*\Domain Users'), [string] $ReportPath = (Get-Location).Path ) $query = { param($IncludeHidden) $shares = Get-SmbShare | Where-Object { $_.Name -notin 'ADMIN$', 'IPC$', 'print$' -and $_.Name -notmatch '^[A-Z]\$$' -and $_.ShareType -eq 'FileSystemDirectory' -and ($IncludeHidden -or -not $_.Name.EndsWith('$')) } foreach ($s in $shares) { foreach ($a in (Get-SmbShareAccess -Name $s.Name)) { [pscustomobject]@{ Freigabe = $s.Name; Pfad = $s.Path; Ebene = 'Freigabe'; Konto = $a.AccountName Recht = [string]$a.AccessRight; Art = [string]$a.AccessControlType; Vererbt = '' } } try { foreach ($r in (Get-Acl -Path $s.Path -ErrorAction Stop).Access) { [pscustomobject]@{ Freigabe = $s.Name; Pfad = $s.Path; Ebene = 'NTFS'; Konto = [string]$r.IdentityReference Recht = ([string]$r.FileSystemRights -replace ', Synchronize', ''); Art = [string]$r.AccessControlType Vererbt = $r.IsInherited } } } catch { [pscustomobject]@{ Freigabe = $s.Name; Pfad = $s.Path; Ebene = 'NTFS'; Konto = 'Fehler' Recht = $_.Exception.Message; Art = ''; Vererbt = '' } } } } $rows = [System.Collections.Generic.List[object]]::new() foreach ($computer in $ComputerName) { try { $entries = if ($computer -in 'localhost', '.', $env:COMPUTERNAME) { & $query $IncludeHidden.IsPresent } else { Invoke-Command -ComputerName $computer -ScriptBlock $query -ArgumentList $IncludeHidden.IsPresent -ErrorAction Stop } foreach ($e in $entries) { $broad = $false foreach ($pattern in $BroadGroup) { if ($e.Konto -like $pattern) { $broad = $true; break } } $writes = $e.Recht -match 'FullControl|Modify|Write|Full|Change|268435456|1073741824' $rating = if ($e.Art -eq 'Allow' -and $broad -and $writes -and $e.Ebene -eq 'NTFS') { 'Prüfen' } elseif ($e.Art -eq 'Allow' -and $broad -and $writes) { 'Hinweis' } else { '' } $rows.Add([pscustomobject]@{ Server = $computer; Freigabe = $e.Freigabe; Pfad = $e.Pfad; Ebene = $e.Ebene; Konto = $e.Konto Recht = $e.Recht; Art = $e.Art; Vererbt = $e.Vererbt; Bewertung = $rating }) } } catch { Write-Warning "${computer}: $($_.Exception.Message)" } } $rows $check = @($rows | Where-Object Bewertung -eq 'Prüfen') $shareCount = @($rows | Select-Object Server, Freigabe -Unique).Count Write-Host "$shareCount Freigaben, $($check.Count) Einträge mit breitem Schreibzugriff auf NTFS-Ebene." -ForegroundColor $(if ($check) { 'Yellow' } else { 'Green' }) $now = Get-Date $title = "Freigaben und Rechte - $($now.ToString('dd.MM.yyyy'))" $css = '<style>body{font-family:Segoe UI,Arial,sans-serif;font-size:13px}table{border-collapse:collapse;margin-bottom:20px}td,th{border:1px solid #ccc;padding:4px 8px}th{background:#eee}</style>' $html = ConvertTo-Html -Title $title -Head $css -PreContent "<h2>$title</h2><p>$shareCount Freigaben auf $($ComputerName.Count) Servern, $($check.Count) Einträge zum Prüfen.</p>" -Body ( ($check | ConvertTo-Html -Fragment -PreContent '<h3>Breiter Schreibzugriff (NTFS)</h3>' | Out-String) + ($rows | Sort-Object Server, Freigabe, Ebene | ConvertTo-Html -Fragment -PreContent '<h3>Alle Freigaben</h3>' | Out-String)) | Out-String $html = $html -replace '<td>Prüfen</td>', '<td style="background:#fff3cd">Prüfen</td>' $base = Join-Path $ReportPath ("Freigaben_{0:yyyy-MM-dd}" -f $now) $html | Set-Content -Path "$base.html" -Encoding UTF8 $rows | Export-Csv -Path "$base.csv" -NoTypeInformation -Delimiter ';' -Encoding UTF8 Write-Host "Bericht: $base.html und $base.csv" |