From db35d86df19817d24d324390e6fccf28a931532b Mon Sep 17 00:00:00 2001 From: Alejandro Rosales Date: Wed, 23 Sep 2026 08:36:16 -0600 Subject: [PATCH] Manage workstation RDP and WinRM through client GPO --- docs/workstation-remote-access.md | 36 +++++++++ scripts/Enable-SguWorkstationRemoteAccess.ps1 | 78 +++++++++++++++++++ scripts/Initialize-SguDomainController.ps1 | 6 ++ ...stall-SguWorkstationRemoteAccessPolicy.ps1 | 77 ++++++++++++++++++ scripts/New-SguBootstrapPackages.ps1 | 2 + 5 files changed, 199 insertions(+) create mode 100644 docs/workstation-remote-access.md create mode 100644 scripts/Enable-SguWorkstationRemoteAccess.ps1 create mode 100644 scripts/Install-SguWorkstationRemoteAccessPolicy.ps1 diff --git a/docs/workstation-remote-access.md b/docs/workstation-remote-access.md new file mode 100644 index 0000000..f07ad7d --- /dev/null +++ b/docs/workstation-remote-access.md @@ -0,0 +1,36 @@ +# Acceso remoto administrado por el dominio + +`Install-SguWorkstationRemoteAccessPolicy.ps1` registra un script de inicio de +equipo en la GPO existente **SGU - Windows client experience**, vinculada a +`OU=Laboratorio`. El bootstrap del controlador lo instala después de crear esa +GPO. No crea una tarea programada en los clientes. + +Al arrancar una estación Windows 10 u 11 unida al dominio, el script activa +Escritorio remoto con NLA y PowerShell Remoting, inicia `TermService` y `WinRM`, +y añade el grupo `LCI\SG-Laboratorio-Usuarios-RDP` a Usuarios de escritorio +remoto. Sus reglas de firewall admiten los puertos TCP 3389 y 5985 y UDP 3389 +solo desde la subred local. En arranques siguientes comprueba el estado y solo +corrige las diferencias. + +Para aplicar una versión nueva a un cliente, ejecute PowerShell como +administrador y después reinicie: + +```powershell +gpupdate /target:computer /force +Restart-Computer +``` + +La GPO de actualización del proveedor de credenciales también se ejecuta al +inicio de equipo; `gpupdate` sin reiniciar no instala el proveedor nuevo. +Compruebe la aplicación con `gpresult /scope computer /r`, `Test-WSMan` y una +conexión RDP desde la misma subred. Si el equipo no puede autenticarse ante +el controlador (`Test-ComputerSecureChannel` devuelve `False`), repare primero +la relación de confianza desde el propio cliente con credenciales de dominio +autorizadas; un equipo sin canal seguro no puede recibir de forma fiable sus +políticas. No elimine ni vuelva a crear su objeto de AD para forzar una GPO. + +Desde un equipo administrador no unido al dominio, PowerShell Remoting por +HTTP requiere indicar `-Credential` y confiar explícitamente en el destino +mediante `TrustedHosts`, o utilizar WinRM por HTTPS. `Test-WSMan` solo verifica +el listener; no inicia sesión. Las reglas locales de la estación no abren +puertos en Azure ni en el router del laboratorio. diff --git a/scripts/Enable-SguWorkstationRemoteAccess.ps1 b/scripts/Enable-SguWorkstationRemoteAccess.ps1 new file mode 100644 index 0000000..3a3a196 --- /dev/null +++ b/scripts/Enable-SguWorkstationRemoteAccess.ps1 @@ -0,0 +1,78 @@ +[CmdletBinding()] +param([string]$RemoteDesktopPrincipal = 'LCI\SG-Laboratorio-Usuarios-RDP') + +$ErrorActionPreference = 'Stop' +$computer = Get-CimInstance Win32_ComputerSystem +if (-not $computer.PartOfDomain -or $computer.DomainRole -ge 4) { return } + +$terminalKey = 'HKLM:\SYSTEM\CurrentControlSet\Control\Terminal Server' +$rdpKey = Join-Path $terminalKey 'WinStations\RDP-Tcp' +if ((Get-ItemPropertyValue -Path $terminalKey -Name fDenyTSConnections) -ne 0) { + Set-ItemProperty -Path $terminalKey -Name fDenyTSConnections -Value 0 +} +if ((Get-ItemPropertyValue -Path $rdpKey -Name UserAuthentication) -ne 1) { + Set-ItemProperty -Path $rdpKey -Name UserAuthentication -Value 1 +} + +foreach ($name in @('TermService', 'WinRM')) { + $service = Get-Service -Name $name + if ($service.StartType -ne 'Automatic') { Set-Service -Name $name -StartupType Automatic } + if ($service.Status -ne 'Running') { Start-Service -Name $name } +} + +# Each domain refresh carries this script through SYSVOL. Apply only the +# narrowly scoped inbound rules required by an administrator on the same LAN. +$rules = @( + @{ Name = 'SGU-Workstation-WinRM-HTTP'; Protocol = 'TCP'; Port = '5985' }, + @{ Name = 'SGU-Workstation-RDP-TCP'; Protocol = 'TCP'; Port = '3389' }, + @{ Name = 'SGU-Workstation-RDP-UDP'; Protocol = 'UDP'; Port = '3389' } +) +foreach ($rule in $rules) { + $existing = Get-NetFirewallRule -Name $rule.Name -ErrorAction SilentlyContinue + if ($existing) { + $port = $existing | Get-NetFirewallPortFilter + $address = $existing | Get-NetFirewallAddressFilter + $valid = $existing.Enabled -eq 'True' -and $existing.Action -eq 'Allow' -and + $existing.Direction -eq 'Inbound' -and $existing.Profile -eq 'Any' -and + $port.Protocol -eq $rule.Protocol -and [string]$port.LocalPort -eq $rule.Port -and + @($address.RemoteAddress).Count -eq 1 -and $address.RemoteAddress -eq 'LocalSubnet' + if ($valid) { continue } + $existing | Remove-NetFirewallRule + } + New-NetFirewallRule -Name $rule.Name -DisplayName $rule.Name -Enabled True ` + -Direction Inbound -Action Allow -Profile Any -Protocol $rule.Protocol ` + -LocalPort $rule.Port -RemoteAddress LocalSubnet | Out-Null +} + +# WinRM's administrative-template policy creates the listener. This also +# restores the Windows PowerShell session endpoint when it was disabled. +$listener = @(Get-ChildItem WSMan:\localhost\Listener -ErrorAction SilentlyContinue | + Where-Object { $_.Keys -contains 'Transport=HTTP' }) +$endpoint = Get-PSSessionConfiguration -Name Microsoft.PowerShell -ErrorAction SilentlyContinue +if (-not $listener -or -not $endpoint) { + Enable-PSRemoting -Force -SkipNetworkProfileCheck | Out-Null +} + +# The built-in local group has a stable SID across Windows display languages. +$groupSid = [Security.Principal.SecurityIdentifier]::new('S-1-5-32-555') +$groupName = ($groupSid.Translate([Security.Principal.NTAccount]).Value -split '\\', 2)[1] +try { + $principalSid = ([Security.Principal.NTAccount]::new($RemoteDesktopPrincipal)).Translate( + [Security.Principal.SecurityIdentifier]).Value + $group = [ADSI]("WinNT://$env:COMPUTERNAME/$groupName,group") + $memberSids = @($group.psbase.Invoke('Members') | ForEach-Object { + try { + $bytes = $_.GetType().InvokeMember('objectSid', + [Reflection.BindingFlags]::GetProperty, $null, $_, $null) + if ($bytes) { ([Security.Principal.SecurityIdentifier]::new([byte[]]$bytes, 0)).Value } + } + catch { } + }) + if ($memberSids -notcontains $principalSid) { + Add-LocalGroupMember -Group $groupName -Member $principalSid + } +} +catch { + # A temporarily unavailable DC must not prevent RDP and WinRM from starting. + Write-Warning "Remote Desktop group membership could not be verified: $($_.Exception.Message)" +} diff --git a/scripts/Initialize-SguDomainController.ps1 b/scripts/Initialize-SguDomainController.ps1 index 86b5f47..8312d16 100644 --- a/scripts/Initialize-SguDomainController.ps1 +++ b/scripts/Initialize-SguDomainController.ps1 @@ -519,6 +519,8 @@ foreach ($requiredPath in @( (Join-Path $scriptsRoot 'New-LabCertificate.ps1'), (Join-Path $scriptsRoot 'Set-LabBrokerDns.ps1'), (Join-Path $scriptsRoot 'Set-SguDomainComputerPolicies.ps1'), + (Join-Path $scriptsRoot 'Enable-SguWorkstationRemoteAccess.ps1'), + (Join-Path $scriptsRoot 'Install-SguWorkstationRemoteAccessPolicy.ps1'), (Join-Path $scriptsRoot 'Set-SguDomainUserPolicies.ps1'), (Join-Path $scriptsRoot 'Set-SguLaboratorioWallpaperPolicy.ps1'), (Join-Path $scriptsRoot 'Enable-SguServerRemoteManagement.ps1'), @@ -820,6 +822,10 @@ $collectorFqdn = "$env:COMPUTERNAME.$DomainName" -TargetOuDn $laboratoryOuDn ` -DomainController $env:COMPUTERNAME ` -EventCollectorFqdn $collectorFqdn | Out-Null + +& (Join-Path $scriptsRoot 'Install-SguWorkstationRemoteAccessPolicy.ps1') ` + -TargetOuDn $laboratoryOuDn ` + -DomainController $env:COMPUTERNAME | Out-Null & (Join-Path $scriptsRoot 'Install-SguDomainMonitoring.ps1') ` -CollectorFqdn $collectorFqdn ` -ComputerOuDn $laboratoryOuDn ` diff --git a/scripts/Install-SguWorkstationRemoteAccessPolicy.ps1 b/scripts/Install-SguWorkstationRemoteAccessPolicy.ps1 new file mode 100644 index 0000000..1b07217 --- /dev/null +++ b/scripts/Install-SguWorkstationRemoteAccessPolicy.ps1 @@ -0,0 +1,77 @@ +[CmdletBinding(SupportsShouldProcess)] +param( + [string]$TargetOuDn = 'OU=Laboratorio,DC=lci,DC=lasalle,DC=mx', + [string]$GpoName = 'SGU - Windows client experience', + [string]$DomainController = $env:COMPUTERNAME +) + +$ErrorActionPreference = 'Stop' +$identity = [Security.Principal.WindowsIdentity]::GetCurrent() +if (-not ([Security.Principal.WindowsPrincipal]::new($identity)).IsInRole( + [Security.Principal.WindowsBuiltInRole]::Administrator)) { + throw 'Run this script elevated on the domain controller.' +} +Import-Module ActiveDirectory -ErrorAction Stop +Import-Module GroupPolicy -ErrorAction Stop + +$targetOu = Get-ADOrganizationalUnit -Identity $TargetOuDn -Server $DomainController +$domain = Get-ADDomain -Server $DomainController +if (-not $targetOu.DistinguishedName.EndsWith($domain.DistinguishedName, + [StringComparison]::OrdinalIgnoreCase)) { + throw 'The target OU is outside the domain.' +} +$domainName = $domain.DNSRoot +$gpo = Get-GPO -Name $GpoName -Domain $domainName -Server $DomainController -ErrorAction Stop +$links = @(Get-GPInheritance -Target $TargetOuDn -Domain $domainName -Server $DomainController).GpoLinks +if (-not @($links | Where-Object { $_.DisplayName -eq $GpoName -and + [string]$_.Enabled -in @('True','Yes') }).Count) { + throw "The existing GPO '$GpoName' must be linked and enabled on $TargetOuDn." +} + +# The existing machine GPO also manages the credential tile. The startup +# script is a native Group Policy extension, not a scheduled client task. +$scriptName = 'Enable-SguWorkstationRemoteAccess.ps1' +$sourcePath = Join-Path $PSScriptRoot $scriptName +$startupRoot = Join-Path $env:WINDIR "SYSVOL\domain\Policies\{$($gpo.Id)}\Machine\Scripts" +$startupPath = Join-Path $startupRoot "Startup\$scriptName" +$scriptsIniPath = Join-Path $startupRoot 'scripts.ini' +$source = [IO.File]::ReadAllText($sourcePath) +$unc = "\\$domainName\SYSVOL\$domainName\Policies\{$($gpo.Id)}\Machine\Scripts\Startup\$scriptName" +$ini = "[Startup]`r`n0CmdLine=powershell.exe`r`n0Parameters=-NoProfile -NonInteractive -ExecutionPolicy Bypass -File `"$unc`"`r`n" +$scriptChanged = -not (Test-Path -LiteralPath $startupPath) -or + [IO.File]::ReadAllText($startupPath) -cne $source +$iniChanged = -not (Test-Path -LiteralPath $scriptsIniPath) -or + [IO.File]::ReadAllText($scriptsIniPath) -cne $ini + +if (($scriptChanged -or $iniChanged) -and + $PSCmdlet.ShouldProcess($startupRoot, 'Install computer startup script')) { + New-Item -ItemType Directory -Path (Split-Path $startupPath) -Force | Out-Null + [IO.File]::WriteAllText($startupPath, $source, [Text.UTF8Encoding]::new($false)) + [IO.File]::WriteAllText($scriptsIniPath, $ini, [Text.Encoding]::Unicode) + $gpoDn = "CN={$($gpo.Id)},CN=Policies,CN=System,$($domain.DistinguishedName)" + $adGpo = Get-ADObject -Identity $gpoDn -Server $DomainController ` + -Properties gPCMachineExtensionNames,versionNumber + $extension = '[{42B5FAAE-6536-11D2-AE5A-0000F87571E3}{40B6664F-4972-11D1-A7CA-0000F87571E3}]' + $names = [string]$adGpo.gPCMachineExtensionNames + if ($names.IndexOf($extension, [StringComparison]::OrdinalIgnoreCase) -lt 0) { + Set-ADObject -Identity $gpoDn -Server $DomainController ` + -Replace @{gPCMachineExtensionNames = "$names$extension"} + } + $gptPath = Join-Path (Split-Path (Split-Path $startupRoot -Parent) -Parent) 'GPT.ini' + $gpt = [IO.File]::ReadAllText($gptPath) + $gptVersion = [int]([regex]::Match($gpt, '(?m)^Version=(\d+)\r?$').Groups[1].Value) + $baseVersion = [Math]::Max($gptVersion, [int]$adGpo.versionNumber) + $nextVersion = ($baseVersion -band -65536) -bor (($baseVersion + 1) -band 65535) + [IO.File]::WriteAllText($gptPath, + [regex]::Replace($gpt, '(?m)^Version=\d+\r?$', "Version=$nextVersion"), + [Text.Encoding]::ASCII) + Set-ADObject -Identity $gpoDn -Server $DomainController -Replace @{versionNumber = $nextVersion} +} + +[pscustomobject]@{ + GpoName = $GpoName + GpoId = $gpo.Id + TargetOu = $TargetOuDn + StartupScript = $startupPath + Changed = $scriptChanged -or $iniChanged +} diff --git a/scripts/New-SguBootstrapPackages.ps1 b/scripts/New-SguBootstrapPackages.ps1 index 8cdb1e6..de06e3c 100644 --- a/scripts/New-SguBootstrapPackages.ps1 +++ b/scripts/New-SguBootstrapPackages.ps1 @@ -210,9 +210,11 @@ $serverScripts = @( 'Disable-SguAzureUserRoaming.ps1', 'Enable-SguAzureUserRoaming.ps1', 'Enable-SguServerRemoteManagement.ps1', + 'Enable-SguWorkstationRemoteAccess.ps1', 'Get-SguUsageReport.ps1', 'Get-SguBrokerLog.ps1', 'Install-SguDomainMonitoring.ps1', + 'Install-SguWorkstationRemoteAccessPolicy.ps1', 'Publish-SguFsLogixClientDeployment.ps1', 'Install-SguRustDeskClient.ps1', 'Install-SguRustDeskLinuxEnrollment.ps1',