Supprime les configurations de session inscrites de l'ordinateur.
Syntaxe
Unregister-PSSessionConfiguration [-Name] <string> [-Force] [-NoServiceRestart] [-Confirmer] [-WhatIf] [<CommonParameters>]
Description
L'applet de commande Unregister-PSSessionConfiguration supprime les configurations de session inscrites de l'ordinateur. Il s'agit d'une applet de commande avancée, conçue pour être employée par les administrateurs système pour la gestion des configurations de session personnalisées des utilisateurs.
Si vous supprimez par erreur la configuration de session Microsoft.PowerShell ou Microsoft.PowerShell32 par défaut, utilisez l'applet de commande Enable-PSRemoting pour la restaurer.
Paramètres
-Force
Supprime toutes les invites utilisateur et redémarre le service WinRM sans demander de confirmation. Pour que la modification de la configuration prenne effet, le service doit être redémarré.
Pour empêcher un redémarrage et supprimer l'invite proposant cette opération, utilisez le paramètre NoServiceRestart.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Name <string>
Spécifie les noms des configurations de session à supprimer. Entrez un ou plusieurs noms de configuration. Les caractères génériques sont autorisés. Ce paramètre est obligatoire.
Vous pouvez également diriger un objet de configuration de session vers Unregister-PSSessionConfiguration.
|
Obligatoire ? |
true |
|
Position ? |
1 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
|
Accepter les caractères génériques ? |
false |
-NoServiceRestart
Ne redémarre pas le service WinRM et supprime l'invite proposant de le redémarrer.
Par défaut, lorsque vous entrez une commande Unregister-PSSessionConfiguration, vous êtes invité à redémarrer le service WinRM pour que le changement devienne effectif. Tant que le service WinRM n'a pas été redémarré, les utilisateurs peuvent continuer à utiliser la configuration de session dont l'inscription a été annulée, bien que Get-PSSessionConfiguration ne la trouve pas.
Pour redémarrer le service WinRM sans demande de confirmation, utilisez le paramètre Force. Pour démarrer le service WinRM manuellement, utilisez l'applet de commande Restart-Service.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Confirmer
Vous invite à confirmer l'exécution de la commande.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-WhatIf
Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
|
Entrées |
Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration Vous pouvez diriger un objet de configuration de session de Get-PSSessionConfiguration vers Unregister-PSSessionConfiguration. |
|
Sorties |
Aucun Cette applet de commande ne retourne pas d'objets. |
Remarques
Pour exécuter cette applet de commande sur Windows Vista, Windows Server 2008 et les versions ultérieures de Windows, vous devez démarrer Windows PowerShell avec l'option Exécuter en tant qu'administrateur.
Exemple 1
C:\PS>unregister-pssessionconfiguration -name MaintenanceShell Description ----------- Cette commande supprime la configuration de session MaintenanceShell de l'ordinateur.
Exemple 2
C:\PS>unregister-pssessionconfiguration -maintenanceShell -force Description ----------- Cette commande supprime la configuration de session MaintenanceShell de l'ordinateur. Elle utilise le paramètre Force pour supprimer toutes les messages utilisateur et redémarrer le service WinRM sans demander de confirmation.
Exemple 3
C:\PS>unregister-pssessionconfiguration -name * C:\PS> get-pssessionconfiguration -name * | unregister-pssessionconfiguration Description ----------- Ces commandes suppriment toutes les configurations de session présentes sur l'ordinateur. Elles ont le même effet et peuvent être utilisées indifféremment.
Exemple 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
Description
-----------
Cet exemple montre l'effet du paramètre NoServiceRestart de l'applet de commande Unregister-PSSessionConfiguration. Ce paramètre est conçu pour empêcher le redémarrage d'un service, qui aurait pour effet d'interrompre toutes les sessions de l'ordinateur.
La première commande utilise l'applet de commande Unregister-PSSessionConfiguration pour supprimer la configuration de session MaintenanceShell. Toutefois, étant donné que la commande fait appel au paramètre NoServiceRestart, le service WinRM n'est pas redémarré et la modification n'est pas encore totalement effective.
La deuxième commande utilise l'applet de commande Get-PSSessionConfiguration pour obtenir la session MaintenanceShell. Étant donné que la session a été supprimée de la table de ressources Gestion des services Web, Get-PSSession ne peut pas la retourner.
La troisième commande utilise l'applet de commande New-PSSession pour créer une session sur l'ordinateur local qui utilise la configuration MaintenanceShell. La commande réussit.
La quatrième commande utilise l'applet de commande Restart-Service pour redémarrer le service WinRM.
La cinquième commande fait encore appel à l'applet de commande New-PSSession pour créer une session qui utilise la configuration MaintenanceShell. Cette fois-ci, la session échoue car la configuration MaintenanceShell a été supprimée.
Voir aussi