Set-PSSessionConfiguration

Set-PSSessionConfiguration [-AssemblyName] <string> [-ConfigurationTypeName] <string> [-Name] <string> [-ApplicationBase <string>] [-Force] [-MaximumReceivedDataSizePerCommandMB <double>] [-MaximumReceivedObjectSizeMB <double>] [-NoServiceRestart] [-SecurityDescriptorSDDL <string>] [-ShowSecurityDescriptorUI] [-StartupScript <string>] [-ThreadApartmentState {<STA> | <MTA> | <Unknown>}] [-ThreadOptions {<Default> | <UseNewThread> | <ReuseThread> | <UseCurrentThread>}] [-Confirmer] [-WhatIf] [<CommonParameters>]

C:\PS>set-pssessionconfiguration -name MaintenanceShell -threadApartmentState STA

Description
-----------
Cette commande redéfinit l'état de cloisonnement des threads dans la configuration MaintenanceShell sur STA. La modification est prise en compte lorsque vous redémarrez le service WinRM.

C:\PS>register-pssessionconfiguration -name AdminShell -assemblyName c:\shells\AdminShell.dll -configurationType AdminClass

C:\PS> set-pssessionconfiguration -name AdminShell -startupScript AdminConfig.ps1

C:\PS> set-pssessionconfiguration -name AdminShell -startupScript $null

Description
-----------
Cet exemple indique comment créer, puis modifier une configuration de session.

La première commande utilise l'applet de commande Register-PSSessionConfiguration pour créer la configuration AdminShell. 

La deuxième commande utilise l'applet de commande Set-PSSessionConfiguration pour ajouter le script AdminConfig.ps1 à la configuration. La modification est prise en compte lorsque vous redémarrez WinRM.

La troisième commande supprime le script AdminConfig.ps1 de la configuration. Elle utilise l'applet de commande Set-PSSessionConfiguration avec la valeur $null pour le paramètre StartupScript.

C:\PS>Set-PSSessionConfiguration -name foo -MaximumReceivedObjectSizeMB 20

   WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin\foo\InitializationParameters

ParamName                       ParamValue
---------                       ----------
psmaximumreceivedobjectsizemb   20

"Restart WinRM service"
WinRM service need to be restarted to make the changes effective. Do you want to run the command "restart-service winrm"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y

Description
-----------
Cet exemple montre un exemple de sortie de l'applet de commande Set-PSSessionConfiguration. 

La commande Set-PSSessionConfiguration utilisée dans cet exemple porte la valeur de la propriété MaximumReceivedObjectSizeMB à 20. 

La commande Set-PSSessionConfiguration retourne un objet Microsoft.WSMan.Management.WSManConfigLeafElement qui affiche le nom du paramètre et la nouvelle valeur.

Elle vous invite également à redémarrer le service WinRM. La modification apportée par Set-PSSessionConfiguration n'est pas effective tant que le service WinRM n'a pas été redémarré.

C:\PS>set-pssessionconfiguration -name MaintenanceShell -startupScript c:\ps-test\Maintenance.ps1


   WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin\MaintenanceShell\InitializationParameters

ParamName            ParamValue
---------            ----------
startupscript        c:\ps-test\Mainte...

"Restart WinRM service"
WinRM service need to be restarted to make the changes effective. Do you want to run the command "restart-service winrm"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y


C:\PS> get-pssessionConfiguration maintenanceshell | format-list -property *

xmlns            : https://schemas.microsoft.com/wbem/wsman/1/config/PluginConfiguration
Name             : MaintenanceShell
Filename         : %windir%\system32\pwrshplugin.dll
SDKVersion       : 1
XmlRenderingType : text
lang             : en-US
PSVersion        : 2.0
startupscript    : c:\ps-test\Maintenance.ps1
ResourceUri      : https://schemas.microsoft.com/powershell/MaintenanceShell
SupportsOptions  : true
ExactMatch       : true
Capability       : {Shell}
Permission       :


C:\PS> dir wsman:\localhost\plugin\MaintenanceShell\InitializationParameters

ParamName     ParamValue
---------     ----------
PSVersion     2.0
startupscript c:\ps-test\Maintenance.ps1

Description
-----------
Cette commande présente différentes façons de consulter les résultats d'une commande Set-PSSessionConfiguration.

La première commande utilise l'applet de commande Set-PSSessionConfiguration pour redéfinir le script de démarrage dans la configuration MaintenanceShell sur Maintenance.ps1. La sortie de cette commande montre la modification et vous invite à redémarrer le service WinRM. La réponse est « y » (yes).

La deuxième commande fait appel à l'applet de commande Get-PSSessionConfiguration pour obtenir la configuration de session MaintenanceShell. Elle utilise un opérateur de pipeline (|) pour envoyer les résultats à l'applet de commande Format-List, qui affiche toutes les propriétés de l'objet de configuration de session dans une liste.

La troisième commande utilise le fournisseur de Gestion des services Web pour consulter les paramètres d'initialisation de la configuration MaintenanceShell. Elle fait appel à l'applet de commande Get-ChildItem (alias = dir) pour obtenir les éléments enfants du nœud InitializationParameters pour le plug-in MaintenanceShell.

Pour plus d'informations sur le fournisseur de Gestion des services Web, tapez « get-help wsman ».