Amministrare un server Windows con PowerShell Remoting in HTTPS
Configura PowerShell Remoting tramite HTTPS su Windows Server: certificato, listener WinRM sulla porta 5986, firewall limitato al tuo indirizzo IP e connessione sicura.
In questa pagina
I tuoi valori
Inseriscili una volta: i comandi della guida si aggiornano.
PowerShell Remoting permette di eseguire comandi sul tuo server dalla tua postazione, senza aprire una sessione grafica. Questa guida configura un accesso cifrato in HTTPS sulla porta 5986, con un certificato verificato dal client e un firewall che accetta solo il tuo indirizzo IP.
Come funziona
PowerShell Remoting si basa sul servizio WinRM, attivo per impostazione predefinita su Windows Server.
| Porta | Trasporto | Uso in questa guida |
|---|---|---|
5985 |
HTTP | Resta disponibile in locale, ma chiusa dalla rete |
5986 |
HTTPS | Unico accesso remoto, limitato al tuo indirizzo IP |
Da una postazione fuori dal dominio, l'autenticazione passa da NTLM, che non dimostra l'identità del server. Il certificato HTTPS colma questa lacuna: la tua postazione verifica di stare parlando davvero con il tuo server prima di inviare qualsiasi dato.
Prerequisiti
- Un server con Windows Server 2019, 2022 o 2025, raggiungibile in RDP con un account amministratore.
- Una postazione di amministrazione con Windows, con diritti di amministratore. Il trasporto WinRM non è supportato da PowerShell su Linux e macOS.
- L'indirizzo IP pubblico di questa postazione, preferibilmente fisso.
- Un nome host per il server, ad esempio
srv.tuo-dominio.com.
Scegliere il nome host
Il nome usato per la connessione deve essere identico a quello del certificato. Due possibilità:
- Con un dominio: crea un record DNS di tipo
Ache puntisrv.tuo-dominio.comall'indirizzo del tuo server. - Senza record DNS: scegli un nome e dichiaralo nel file
hostsdella tua postazione, come indicato nel passaggio 6.
1. Verifica WinRM sul server
Apri PowerShell come amministratore sul server:
Get-Service WinRM | Format-Table Name, Status, StartType
Test-WSManIl servizio deve essere nello stato Running e Test-WSMan deve restituire informazioni sul protocollo. In caso contrario, riattiva il servizio:
Enable-PSRemoting -Force2. Crea il certificato
Opzione A: certificato autofirmato
Questa opzione è adatta a un singolo amministratore, perché sei tu a installare il certificato sulla tua postazione. Qui è valido due anni e la sua chiave privata non è esportabile.
$hostName = 'srv.tuo-dominio.com'
$cert = New-SelfSignedCertificate -DnsName $hostName -CertStoreLocation 'Cert:\LocalMachine\My' -KeyExportPolicy NonExportable -NotAfter (Get-Date).AddYears(2)
$cert | Format-List Subject, Thumbprint, NotAfter
New-Item -ItemType Directory -Path 'C:\WinRM' -Force | Out-Null
Export-Certificate -Cert $cert -FilePath 'C:\WinRM\winrm-https.cer'Il file .cer contiene solo la parte pubblica del certificato. Annota l'identificazione personale (Thumbprint): la confronterai sulla tua postazione.
Opzione B: certificato di un'autorità riconosciuta
Se hai già un certificato per questo nome in formato PFX, importalo. Il suo campo CN deve corrispondere al nome host e deve consentire l'autenticazione del server.
$pfxPassword = Read-Host 'PFX password' -AsSecureString
Import-PfxCertificate -FilePath 'C:\WinRM\certificate.pfx' -CertStoreLocation 'Cert:\LocalMachine\My' -Password $pfxPasswordElimina poi il file PFX dal server. Con questa opzione non hai bisogno di importare il certificato sulla tua postazione.
3. Crea il listener HTTPS
$hostName = 'srv.tuo-dominio.com'
$cert = Get-ChildItem Cert:\LocalMachine\My |
Where-Object { $_.Subject -like "CN=$hostName*" } |
Sort-Object NotAfter | Select-Object -Last 1
New-WSManInstance -ResourceURI winrm/config/Listener `
-SelectorSet @{ Address = '*'; Transport = 'HTTPS' } `
-ValueSet @{ Hostname = $hostName; CertificateThumbprint = $cert.Thumbprint }Controlla il risultato:
Get-WSManInstance -ResourceURI winrm/config/Listener -Enumerate |
Format-Table Transport, Port, Hostname, Enabled, CertificateThumbprint
Get-NetTCPConnection -LocalPort 5986 -State ListenNon usare winrm quickconfig -transport:https con un certificato autofirmato: questo comando lo rifiuta.
4. Apri la porta 5986 solo per il tuo indirizzo IP
Dalla tua sessione RDP, questo comando mostra l'indirizzo pubblico visto dal server (sostituisci 3389 se usi un'altra porta RDP):
(Get-NetTCPConnection -LocalPort 3389 -State Established).RemoteAddressSe questo indirizzo è proprio quello della tua postazione di amministrazione, crea la regola:
New-NetFirewallRule -Name 'WinRM-HTTPS-Admin' -DisplayName 'WinRM HTTPS - admin workstation' `
-Direction Inbound -Action Allow -Protocol TCP -LocalPort 5986 -RemoteAddress TUO_IP -Profile AnyCon l'interfaccia grafica
- Crea una regola in entrata per la porta TCP
5986, come spiegato nella guida al firewall di Windows, con l'azione Consenti la connessione (Allow the connection) e tutti i profili. - Apri le Proprietà della regola, poi la scheda Ambito (Scope).
- Sotto Indirizzi IP remoti (Remote IP address), scegli Questi indirizzi IP (These IP addresses), poi aggiungi il tuo indirizzo.
Se la tua offerta include un firewall configurabile dalla console, autorizza anche lì questa porta per il tuo indirizzo.
5. Chiudi l'accesso remoto in HTTP
Per impostazione predefinita Windows autorizza la porta 5985 sulla rete locale, e un indirizzo pubblico può condividere la sua sottorete con altri server. Disattiva queste regole. Il listener HTTP resta attivo per gli strumenti locali.
Get-NetFirewallRule -Name 'WINRM-HTTP-In-TCP*' | Disable-NetFirewallRule
Get-NetFirewallRule -Name 'WINRM-HTTP-In-TCP*' | Format-Table Name, Enabled, ProfileSe in seguito rieseguirai Enable-PSRemoting, queste regole verranno riattivate: ripeti allora questo passaggio.
6. Prepara la postazione di amministrazione
Apri PowerShell come amministratore sulla tua postazione.
Se il nome non esiste nel DNS pubblico, dichiaralo:
Add-Content -Path "$env:SystemRoot\System32\drivers\etc\hosts" -Value 'IP_DEL_TUO_SERVER srv.tuo-dominio.com'Con un certificato autofirmato, copia C:\WinRM\winrm-https.cer sulla tua postazione, ad esempio con copia e incolla nella sessione RDP, poi importalo dalla cartella in cui si trova:
Import-Certificate -FilePath '.\winrm-https.cer' -CertStoreLocation 'Cert:\LocalMachine\Root'7. Connettiti
Il nome dell'account si scrive NOME_DEL_SERVER\TUO_USER. Il comando hostname restituisce il nome del server. Su un controller di dominio, usa DOMINIO\TUO_USER.
$cred = Get-Credential -UserName 'NOME_DEL_SERVER\TUO_USER' -Message 'Server administrator account'
Enter-PSSession -ComputerName srv.tuo-dominio.com -UseSSL -Credential $credIl prompt mostra allora il nome del server. Prova, poi esci:
hostname
whoami
Exit-PSSessionPer eseguire un comando senza sessione interattiva, oppure riutilizzare una connessione e copiare un file:
Invoke-Command -ComputerName srv.tuo-dominio.com -UseSSL -Credential $cred -ScriptBlock { Get-Service WinRM }
$session = New-PSSession -ComputerName srv.tuo-dominio.com -UseSSL -Credential $cred
Copy-Item -Path '.\script.ps1' -Destination 'C:\WinRM\' -ToSession $session
Remove-PSSession $sessionVerificare la configurazione
Sul server, controlla la regola del firewall e l'assenza di trasporto non cifrato. Gli ultimi due parametri devono valere false:
Get-NetFirewallRule -Name 'WinRM-HTTPS-Admin' | Get-NetFirewallAddressFilter | Format-Table RemoteAddress
Get-NetFirewallPortFilter -Protocol TCP |
Where-Object { $_.LocalPort -contains '5986' } |
Get-NetFirewallRule | Format-Table Name, Enabled, Action, Profile
Get-Item WSMan:\localhost\Service\AllowUnencrypted
Get-Item WSMan:\localhost\Service\Auth\BasicUna sola regola attiva deve autorizzare la porta 5986. Dalla tua postazione, la porta HTTPS deve rispondere e la porta HTTP no:
Test-NetConnection srv.tuo-dominio.com -Port 5986 -WarningAction SilentlyContinue | Select-Object TcpTestSucceeded
Test-NetConnection srv.tuo-dominio.com -Port 5985 -WarningAction SilentlyContinue | Select-Object TcpTestSucceeded
Test-WSMan -ComputerName srv.tuo-dominio.com -UseSSLIl primo test deve mostrare True, il secondo False. Infine, da una altra connessione Internet, ad esempio una condivisione di connessione dal cellulare, anche la porta 5986 deve mostrare False.
Aggiornare la configurazione
Il tuo indirizzo IP è cambiato
Connettiti in RDP al server e sostituisci l'indirizzo autorizzato:
Set-NetFirewallRule -Name 'WinRM-HTTPS-Admin' -RemoteAddress TUO_IPRinnovare il certificato
Prima della scadenza, crea un nuovo certificato come nel passaggio 2, poi associalo al listener:
$hostName = 'srv.tuo-dominio.com'
$cert = Get-ChildItem Cert:\LocalMachine\My |
Where-Object { $_.Subject -like "CN=$hostName*" } |
Sort-Object NotAfter | Select-Object -Last 1
Set-WSManInstance -ResourceURI winrm/config/Listener `
-SelectorSet @{ Address = '*'; Transport = 'HTTPS' } `
-ValueSet @{ CertificateThumbprint = $cert.Thumbprint }Importa poi il nuovo file .cer sulla tua postazione, prova la connessione, quindi elimina il vecchio certificato da entrambe le parti.
Rimuovere tutto
Remove-WSManInstance -ResourceURI winrm/config/Listener -SelectorSet @{ Address = '*'; Transport = 'HTTPS' }
Remove-NetFirewallRule -Name 'WinRM-HTTPS-Admin'Risoluzione dei problemi
La porta non risponde
WinRM cannot complete the operation. Verify that the specified computer name is valid, that the computer is accessible over the network, and that a firewall exception for the WinRM service is enabled.Verifica in quest'ordine:
- Il tuo indirizzo pubblico attuale è proprio quello della regola
WinRM-HTTPS-Admin. - Il listener esiste e la porta
5986è in ascolto sul server. - Il nome host punta all'indirizzo corretto:
Resolve-DnsName srv.tuo-dominio.com. - Il firewall configurabile dalla console della tua offerta, se ne usi uno, autorizza questa porta.
Autorità di certificazione sconosciuta
The SSL certificate is signed by an unknown certificate authority.Il certificato non è considerato attendibile dalla tua postazione. Importa il file .cer in Cert:\LocalMachine\Root da un PowerShell amministratore e verifica che sia proprio il certificato usato dal listener.
Il nome non corrisponde al certificato
The SSL certificate contains a common name (CN) that does not match the hostname.Connettiti con il nome esatto del certificato, non con l'indirizzo IP o con un altro alias.
Certificato scaduto o revoca non verificabile
The SSL certificate is expired.
The SSL certificate could not be checked for revocation.Rinnova il certificato scaduto. Per il secondo messaggio, assicurati che la tua postazione possa raggiungere i server di revoca dell'autorità.
Il client richiede HTTPS o TrustedHosts
The WinRM client cannot process the request. If the authentication scheme is different from Kerberos, or if the client computer is not joined to a domain, then HTTPS transport must be used or the destination machine must be added to the TrustedHosts configuration setting.Nel tuo comando manca il parametro -UseSSL. Non aggiungere il server a TrustedHosts: servirebbe solo a nascondere l'assenza di verifica della sua identità.
Accesso negato
Access is denied.Controlla il nome del server, l'account e la password. Per impostazione predefinita, solo i membri del gruppo Administrators possono connettersi.
Anche un account amministratore locale diverso da quello integrato può essere rifiutato a causa delle restrizioni remote di UAC. Usa di preferenza l'account Administrator integrato o un account di dominio. Il valore di registro LocalAccountTokenFilterPolicy rimuove questa restrizione, ma per tutti gli account locali della macchina: attivalo solo con piena consapevolezza.
La creazione del listener non riesce
Cannot create a WinRM listener on HTTPS because this machine does not have an appropriate certificate.Questo messaggio compare in particolare con winrm quickconfig -transport:https: usa New-WSManInstance come nel passaggio 3. Verifica inoltre che il certificato non sia scaduto e che il suo CN corrisponda esattamente a Hostname.
Se esiste già un listener HTTPS, eliminalo con Remove-WSManInstance, poi ricrealo.
Accesso negato verso un'altra macchina dalla sessione
La tua password non viene trasmessa al server remoto, che quindi non può autenticarsi al tuo posto su una condivisione di rete o su un altro server. È il cosiddetto problema del «secondo hop». Esegui il comando direttamente sulla macchina di destinazione, oppure passa credenziali esplicite al comando interessato.