Unregister-PSSessionConfiguration

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

Cette applet de commande est disponible uniquement sur la plateforme Windows.

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 que la modification soit effective, Unregister-PSSessionConfiguration redémarre le service WinRM. Pour empêcher le redémarrage, spécifiez le paramètre NoServiceRestart.

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

Cet exemple supprime 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 (http://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 New-PSSession 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 New-PSSession tente de créer une session qui utilise la configuration MaintenanceShell. Cette fois, la session échoue, car la configuration 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 vers cette applet de commande.

Cette applet de commande ne retourne aucune sortie.

Cette applet de commande est disponible uniquement sur les plateformes Windows.

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