Elimina le configurazioni di sessione registrate dal computer.
Sintassi
Unregister-PSSessionConfiguration [-Name] <string> [-Force] [-NoServiceRestart] [-Confirm] [-WhatIf] [<CommonParameters>]
Descrizione
Il cmdlet Unregister-PSSessionConfiguration elimina le configurazioni di sessione registrate dal computer. Si tratta di un cmdlet avanzato progettato per essere utilizzato da amministratori di sistema per gestire le configurazioni di sessione personalizzate degli utenti.
Se si eliminano accidentalmente le configurazioni di sessione Microsoft.PowerShell o Microsoft.PowerShell32 predefinite, utilizzare il cmdlet Enable-PSRemoting per ripristinarle.
Parametri
-Force
Elimina tutti i prompt dell'utente e riavvia il servizio Gestione remota Windows senza richieste. Con il riavvio del servizio la modifica della configurazione diventa effettiva.
Per impedire un riavvio ed eliminare il prompt di riavvio, utilizzare il parametro NoServiceRestart.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Name <string>
Specifica i nomi delle configurazioni di sessione da eliminare. Immettere uno o più nomi di configurazione. È consentito l'utilizzo di caratteri jolly. Questo parametro è obbligatorio.
È inoltre possibile reindirizzare un oggetto configurazione di sessione a Unregister-PSSessionConfiguration.
|
Obbligatorio? |
true |
|
Posizione? |
1 |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
true (ByPropertyName) |
|
Accettare caratteri jolly? |
false |
-NoServiceRestart
Non riavvia il servizio Gestione remota Windows ed elimina il prompt per riavviare il servizio.
Per impostazione predefinita, quando si immette un comando Unregister-PSSessionConfiguration, viene richiesto di riavviare il servizio Gestione remota Windows per rendere effettiva la modifica. Finché il servizio Gestione remota Windows non viene riavviato, gli utenti possono ancora utilizzare la configurazione di sessione non registrata, anche se non viene trovata da Get-PSSessionConfiguration.
Per riavviare il servizio Gestione remota Windows senza visualizzare alcun prompt, utilizzare il parametro Force. Per riavviare manualmente il servizio Gestione remota Windows, utilizzare il cmdlet Restart-Service.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-Confirm
Chiede una conferma prima di eseguire il comando.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
-WhatIf
Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.
|
Obbligatorio? |
false |
|
Posizione? |
named |
|
Valore predefinito |
|
|
Accettare input da pipeline? |
false |
|
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
|
Input |
Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration È possibile reindirizzare un oggetto configurazione di sessione da Get-PSSessionConfiguration a Unregister-PSSessionConfiguration. |
|
Output |
Nessuno Questo cmdlet non restituisce alcun oggetto. |
Note
Per eseguire questo cmdlet in Windows Vista, Windows Server 2008 e nelle versioni successive di Windows, è necessario avviare Windows PowerShell con l'opzione "Esegui come amministratore".
Esempio 1
C:\PS>unregister-pssessionconfiguration -name MaintenanceShell Descrizione ----------- Questo comando elimina la configurazione di sessione MaintenanceShell dal computer.
Esempio 2
C:\PS>unregister-pssessionconfiguration -maintenanceShell -force Descrizione ----------- Questo comando elimina la configurazione di sessione MaintenanceShell dal computer. Il comando utilizza il parametro Force per eliminare tutti i messaggi dell'utente e riavviare il servizio Gestione remota Windows senza chiedere conferma.
Esempio 3
C:\PS>unregister-pssessionconfiguration -name * C:\PS> get-pssessionconfiguration -name * | unregister-pssessionconfiguration Descrizione ----------- Questi comandi eliminano tutte le configurazioni di sessione nel computer. I comandi hanno lo stesso effetto pertanto sono intercambiabili.
Esempio 4
C:\PS>unregister-pssessionconfiguration -name maintenanceShell -noServiceRestart
C:\PS> get-pssessionconfiguration -name maintenanceShell
Get-PSSessionConfiguration -name maintenanceShell : No Session Configuration matches criteria "maintenanceShell".
+ CategoryInfo : NotSpecified: (:) [Write-Error], WriteErrorException
+ FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException
C:\PS> new-pssession -configurationName MaintenanceShell
Id Name ComputerName State Configuration Availability
-- ---- ------------ ----- ------------- ------------
1 Session1 localhost Opened MaintenanceShell Available
C:\PS> restart-service winrm
C:\PS> new-pssession -configurationName MaintenanceShell
[localhost] Connecting to remote server failed with the following error message : The WS-Management service cannot process the request. The resource
URI (https://schemas.microsoft.com/powershell/MaintenanceShell) was not found in the WS-Management catalog. The catalog contains the metadata that describes resour
ces, or logical endpoints. For more information, see the about_Remote_Troubleshooting Help topic.
+ CategoryInfo : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
+ FullyQualifiedErrorId : PSSessionOpenFailed
Descrizione
-----------
In questo esempio viene illustrato l'effetto dell'utilizzo del parametro NoServiceRestart di Unregister-PSSessionConfiguration. Questo parametro ha lo scopo di evitare il riavvio di un servizio, il che potrebbe danneggiare le sessioni nel computer.
Con il primo comando si utilizza il cmdlet Unregister-PSSessionConfiguration per eliminare la configurazione di sessione MaintenanceShell. Tuttavia, poiché il comando utilizza il parametro NoServiceRestart, il servizio Gestione remota Windows non viene riavviato e la modifica non è ancora pienamente effettiva.
Il secondo comando utilizza il cmdlet Get-PSSessionConfiguration per ottenere la sessione MaintenanceShell. Poiché la sessione è stata rimossa dalla tabella delle risorse di WS-Management, Get-PSSession non può restituirla.
Con il terzo comando si utilizza il cmdlet New-PSSession per creare una sessione nel computer locale che utilizzi la configurazione MaintenanceShell. Il comando ha esito positivo.
Nel quarto comando viene utilizzato il cmdlet Restart-Service per riavviare il servizio Gestione remota Windows.
Con il quinto comando viene nuovamente utilizzato il cmdlet New-PSSession per creare una sessione che utilizzi la configurazione MaintenanceShell. In questo caso, la sessione ha esito negativo perché la configurazione MaintenanceShell è stata eliminata.
Vedere anche