[CmdletBinding()] param( [string]$GpoName = 'La Salle - Workstation remote management', [string]$DomainController = $env:COMPUTERNAME, [string[]]$ManagementAddresses = @('LocalSubnet'), [string]$LocalDnsServer = '', [string]$FallbackDnsServer = '' ) $ErrorActionPreference = 'Stop' Import-Module ActiveDirectory Import-Module GroupPolicy Import-Module NetSecurity $domain = Get-ADDomain -Server $DomainController $dnsRoot = $domain.DNSRoot $domainDn = $domain.DistinguishedName $gpo = Get-GPO -Name $GpoName -Domain $dnsRoot -Server $DomainController -ErrorAction SilentlyContinue $changes = [Collections.Generic.List[string]]::new() if (-not $gpo) { $gpo = New-GPO -Name $GpoName -Domain $dnsRoot -Server $DomainController $changes.Add('Created GPO') } if ($gpo.GpoStatus -ne 'UserSettingsDisabled') { $gpo.GpoStatus = [Microsoft.GroupPolicy.GpoStatus]::UserSettingsDisabled $changes.Add('Computer settings only') } $policyDn = "CN={$($gpo.Id)},CN=Policies,CN=System,$domainDn" $policyRoot = Join-Path $env:WINDIR "SYSVOL\domain\Policies\{$($gpo.Id)}" # Domain-root inheritance includes newly joined computers in CN=Computers. # The WMI filter limits the policy to workstation OSes (Windows 10 and 11). $filterName = 'La Salle - Windows workstations' $filter = Get-ADObject -Server $DomainController -SearchBase "CN=SOM,CN=WMIPolicy,CN=System,$domainDn" ` -LDAPFilter '(objectClass=msWMI-Som)' -Properties msWMI-Name,msWMI-ID,msWMI-Parm2 | Where-Object { $_.'msWMI-Name' -eq $filterName } $query = 'SELECT * FROM Win32_OperatingSystem WHERE ProductType = 1' $encodedQuery = "1;3;10;$($query.Length);WQL;root\CIMv2;$query;" if (@($filter).Count -gt 1) { throw 'Duplicate workstation WMI filters; inspect before editing.' } if (-not $filter) { $filterId = '{' + [guid]::NewGuid().ToString().ToUpperInvariant() + '}' $timestamp = (Get-Date).ToUniversalTime().ToString('yyyyMMddHHmmss.ffffff-000') $filter = New-ADObject -Server $DomainController -Name $filterId -Type msWMI-Som ` -Path "CN=SOM,CN=WMIPolicy,CN=System,$domainDn" -OtherAttributes @{ 'msWMI-Name' = $filterName; 'msWMI-ID' = $filterId 'msWMI-Parm1' = 'Domain workstation management; excludes servers and DCs.' 'msWMI-Parm2' = $encodedQuery; 'msWMI-Author' = 'Domain administrators' 'msWMI-CreationDate' = $timestamp; 'msWMI-ChangeDate' = $timestamp } -PassThru $filter = Get-ADObject $filter.DistinguishedName -Server $DomainController -Properties msWMI-ID $changes.Add('Created workstation filter') } elseif ($filter.'msWMI-Parm2' -ne $encodedQuery) { throw 'Existing workstation filter has a different query; inspect before changing it.' } $filterReference = "[$dnsRoot;$($filter.'msWMI-ID');0]" $policy = Get-ADObject $policyDn -Server $DomainController -Properties gPCWQLFilter if ($policy.gPCWQLFilter -ne $filterReference) { Set-ADObject $policyDn -Server $DomainController -Replace @{gPCWQLFilter=$filterReference} $changes.Add('Linked workstation filter') } $registry = @( @{Key='HKLM\Software\Policies\Microsoft\Windows NT\Terminal Services'; Name='fDenyTSConnections'; Type='DWord'; Value=0}, @{Key='HKLM\Software\Policies\Microsoft\Windows NT\Terminal Services'; Name='UserAuthentication'; Type='DWord'; Value=1}, @{Key='HKLM\Software\Policies\Microsoft\Windows\WinRM\Service'; Name='AllowAutoConfig'; Type='DWord'; Value=1}, @{Key='HKLM\Software\Policies\Microsoft\Windows\WinRM\Service'; Name='IPv4Filter'; Type='String'; Value='*'}, @{Key='HKLM\Software\Policies\Microsoft\Windows\WinRM\Service'; Name='IPv6Filter'; Type='String'; Value='*'}, @{Key='HKLM\Software\Policies\Microsoft\Windows\WinRM\Service\WinRS'; Name='AllowRemoteShellAccess'; Type='DWord'; Value=1} ) foreach ($setting in $registry) { $current = Get-GPRegistryValue -Name $GpoName -Domain $dnsRoot -Server $DomainController ` -Key $setting.Key -ValueName $setting.Name -ErrorAction SilentlyContinue if (-not $current -or [string]$current.Value -ne [string]$setting.Value -or [string]$current.Type -ne $setting.Type) { Set-GPRegistryValue -Name $GpoName -Domain $dnsRoot -Server $DomainController ` -Key $setting.Key -ValueName $setting.Name -Type $setting.Type -Value $setting.Value | Out-Null $changes.Add("Registry: $($setting.Name)") } } # Firewall policy is enforced by the native firewall CSE, including gpupdate. # RPC dynamic ports are restricted to their Windows service, not opened broadly. $ruleDefinitions = @( @{Name='WinRM'; Protocol='TCP'; Port='5985'; Service='WinRM'}, @{Name='RDP-TCP'; Protocol='TCP'; Port='3389'; Service='TermService'}, @{Name='RDP-UDP'; Protocol='UDP'; Port='3389'; Service='TermService'}, @{Name='RPC-Endpoint'; Protocol='TCP'; Port='RPCEPMap'; Service='RpcSs'}, @{Name='WMI'; Protocol='TCP'; Port='Any'; Service='winmgmt'}, @{Name='EventLog'; Protocol='TCP'; Port='RPC'; Service='EventLog'}, @{Name='Services'; Protocol='TCP'; Port='RPC'; Service='services.exe'; Program='%SystemRoot%\System32\services.exe'}, @{Name='Tasks'; Protocol='TCP'; Port='RPC'; Service='Schedule'}, @{Name='Firewall'; Protocol='TCP'; Port='RPC'; Service='MpsSvc'}, @{Name='Volumes'; Protocol='TCP'; Port='RPC'; Service='vds'}, @{Name='Performance'; Protocol='TCP'; Port='RPC'; Service='pla'}, @{Name='SMB'; Protocol='TCP'; Port='445'; Service='LanmanServer'; Program='System'} ) $session = Open-NetGPO -PolicyStore "$dnsRoot\$GpoName" -DomainController $DomainController $firewallChanged = $false foreach ($definition in $ruleDefinitions) { $name = 'LaSalle-Management-' + $definition.Name $program = '%SystemRoot%\System32\svchost.exe' $service = $definition.Service if ($definition.Program) { $program = $definition.Program } if ($service -eq 'services.exe') { $service = 'Any' } $existing = Get-NetFirewallRule -GPOSession $session -Name $name -ErrorAction SilentlyContinue $valid = $false if ($existing) { $port = $existing | Get-NetFirewallPortFilter $address = $existing | Get-NetFirewallAddressFilter $application = $existing | Get-NetFirewallApplicationFilter $svc = $existing | Get-NetFirewallServiceFilter $valid = $existing.Enabled -eq 'True' -and $existing.Profile -eq 'Any' -and $existing.Action -eq 'Allow' -and $existing.Direction -eq 'Inbound' -and [string]$port.Protocol -eq $definition.Protocol -and [string]$port.LocalPort -eq $definition.Port -and $application.Program -eq $program -and $svc.Service -eq $service -and -not @(Compare-Object @($address.RemoteAddress) $ManagementAddresses).Count } if ($valid) { continue } if ($existing) { $existing | Remove-NetFirewallRule } New-NetFirewallRule -GPOSession $session -Name $name -DisplayName $name ` -Group 'La Salle remote management' -Enabled True -Direction Inbound -Action Allow ` -Profile Any -Protocol $definition.Protocol -LocalPort $definition.Port ` -Program $program -Service $service -RemoteAddress $ManagementAddresses | Out-Null $firewallChanged = $true $changes.Add("Firewall: $name") } if ($firewallChanged) { Save-NetGPO -GPOSession $session } function Set-PolicyFile([string]$RelativePath, [string]$Content) { $path = Join-Path $policyRoot $RelativePath if ((Test-Path -LiteralPath $path) -and [IO.File]::ReadAllText($path) -eq $Content) { return $false } New-Item -ItemType Directory -Path (Split-Path $path) -Force | Out-Null [IO.File]::WriteAllText($path, $Content, [Text.UTF8Encoding]::new($false)) $changes.Add("File: $RelativePath") return $true } $servicesXml = @' '@ $fileChanged = Set-PolicyFile 'Machine\Preferences\Services\Services.xml' $servicesXml $registryXml = @' '@ $fileChanged = (Set-PolicyFile 'Machine\Preferences\Registry\Registry.xml' $registryXml) -or $fileChanged $helperName = 'Enable-SguWorkstationRemoteAccess.ps1' $helper = [IO.File]::ReadAllText((Join-Path $PSScriptRoot $helperName)) $fileChanged = (Set-PolicyFile "Machine\Scripts\Startup\$helperName" $helper) -or $fileChanged $parameters = "-NoProfile -NonInteractive -ExecutionPolicy Bypass -File `"\\$dnsRoot\SYSVOL\$dnsRoot\Policies\{$($gpo.Id)}\Machine\Scripts\Startup\$helperName`"" if ($LocalDnsServer) { [Net.IPAddress]::Parse($LocalDnsServer) | Out-Null $parameters += " -LocalDnsServer $LocalDnsServer" if ($FallbackDnsServer) { [Net.IPAddress]::Parse($FallbackDnsServer) | Out-Null $parameters += " -FallbackDnsServer $FallbackDnsServer" } } elseif ($FallbackDnsServer) { throw 'FallbackDnsServer requires a LocalDnsServer.' } $scriptsIni = "[Startup]`r`n0CmdLine=powershell.exe`r`n0Parameters=$parameters`r`n" $fileChanged = (Set-PolicyFile 'Machine\Scripts\scripts.ini' $scriptsIni) -or $fileChanged $policy = Get-ADObject $policyDn -Server $DomainController -Properties gPCMachineExtensionNames,versionNumber $extensions = [string]$policy.gPCMachineExtensionNames foreach ($extension in @( '[{B087BE9D-ED37-454F-AF9C-04291E351182}{BEE07A6A-EC9F-4659-B8C9-0B193F6C7FE2}]', '[{91FBB303-0CD5-4055-BF42-E512A681B325}{CC5746A9-9B74-4BE5-AE2E-64379C86E0E4}]', '[{42B5FAAE-6536-11D2-AE5A-0000F87571E3}{40B6664F-4972-11D1-A7CA-0000F87571E3}]' )) { if (-not $extensions.Contains($extension)) { $extensions += $extension; $fileChanged = $true } } if ($fileChanged) { # Preserve the user-version word. Sort CSEs as required by Group Policy. $extensions = (@([regex]::Matches($extensions, '\[[^\]]+\]') | ForEach-Object Value | Sort-Object -Unique) -join '') $oldVersion = [long]$policy.versionNumber $version = ($oldVersion -band 0xFFFF0000L) -bor (($oldVersion + 1) -band 0xFFFFL) Set-ADObject $policyDn -Server $DomainController -Replace @{gPCMachineExtensionNames=$extensions; versionNumber=[int]$version} [IO.File]::WriteAllText((Join-Path $policyRoot 'GPT.INI'), "[General]`r`nVersion=$version`r`n", [Text.UTF8Encoding]::new($false)) } $links = @(Get-GPInheritance -Target $domainDn -Domain $dnsRoot -Server $DomainController).GpoLinks $link = $links | Where-Object { $_.GpoId -eq $gpo.Id } if (-not $link) { New-GPLink -Guid $gpo.Id -Target $domainDn -Domain $dnsRoot -Server $DomainController -LinkEnabled Yes -Enforced Yes | Out-Null $changes.Add('Linked at domain root') } elseif (-not $link.Enabled -or -not $link.Enforced) { Set-GPLink -Guid $gpo.Id -Target $domainDn -Domain $dnsRoot -Server $DomainController -LinkEnabled Yes -Enforced Yes | Out-Null $changes.Add('Enabled enforced domain link') } [pscustomobject]@{Gpo=$GpoName; Id=[string]$gpo.Id; Domain=$dnsRoot; Changed=($changes.Count -gt 0); Changes=@($changes.ToArray())}