Unregister-PSSessionConfiguration

Unregister-PSSessionConfiguration
    [-Name] <String>
    [-Force]
    [-NoServiceRestart]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

L’applet de commande Unregister-PSSessionConfiguration supprime les configurations de session inscrites de l’ordinateur. Cette applet de commande est conçue pour permettre aux administrateurs système de gérer les configurations de session personnalisées pour les utilisateurs.

Pour rendre la modification effective, redémarre le service WinRM . Pour empêcher le redémarrage, spécifiez le paramètre NoServiceRestart.

Si vous supprimez accidentellement la microsoft.PowerShell par défaut ou configurations de session Microsoft.PowerShell32, utilisez l’applet de commande Enable-PSRemoting pour les restaurer. Pour plus d’informations, consultez about_Session_Configurations.

Cet exemple montre comment supprimer la configuration de session MaintenanceShell de l’ordinateur.

Unregister-PSSessionConfiguration -Name "MaintenanceShell"

Dans cet exemple, nous supprimons la configuration MaintenanceShell et redémarrez le service WinRM. Le paramètre Forcer supprime tous les messages utilisateur pour redémarrer le service WinRM sans demander d’invite.

Unregister-PSSessionConfiguration -Name MaintenanceShell -Force

Ces exemples montrent deux façons de supprimer toutes les configurations de session sur l’ordinateur. Les deux commandes ont le même effet et peuvent être utilisées de manière interchangeable.

Unregister-PSSessionConfiguration -Name *
Get-PSSessionConfiguration -Name * | Unregister-PSSessionConfiguration

Cet exemple montre l’effet de l’utilisation du paramètre NoServiceRestart pour empêcher un redémarrage du service qui perturberait les sessions sur l’ordinateur.

PS> Unregister-PSSessionConfiguration -Name "MaintenanceShell" -NoServiceRestart
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

PS> New-PSSession -ConfigurationName "MaintenanceShell"

Id Name      ComputerName    State    Configuration         Availability
-- ----      ------------    -----    -------------         ------------
1 Session1  localhost       Opened   MaintenanceShell      Available

PS> Restart-Service winrm
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 resources, or logical endpoints.
 For more information, see the about_Remote_Troubleshooting Help topic.
 + CategoryInfo          : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
 + FullyQualifiedErrorId : PSSessionOpenFailed

La Unregister-PSSessionConfiguration supprime la configuration de session MaintenanceShell. Toutefois, étant donné que la commande utilise le paramètre NoServiceRestart , le service WinRM n’est pas redémarré et la modification n’est pas encore complètement efficace.

Ensuite, le Get-PSSessionConfiguration tente d’obtenir la session MaintenanceShell. Étant donné que la session a été supprimée de la table de ressources WS-Management, Get-PSSessionConfiguration ne peut pas la retourner.

L’applet de commande crée une session à l’aide de la configuration MaintenanceShell . La commande réussit. Ensuite, nous redémarrons le service WinRM.

Enfin, l’applet de commande tente de créer une session qui utilise la configuration MaintenanceShell . Cette fois, la session échoue, car la configuration de MaintenanceShell a été supprimée lorsque le service WinRM a redémarré.

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Vous pouvez diriger un objet de configuration de session de Get-PSSessionConfiguration vers cette applet de commande.

Cette applet de commande ne retourne aucun objet.

Pour exécuter cette applet de commande, vous devez démarrer PowerShell à l’aide de l’option Exécuter en tant qu’administrateur.