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"