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>}] [-Confirm] [-WhatIf] [<CommonParameters>]

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

Descrizione
-----------
Con questo comando lo stato dell'apartment del thread nella configurazione MaintenanceShell viene impostato su STA. La modifica è effettiva quando si riavvia il servizio Gestione remota Windows.

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

Descrizione
-----------
In questo esempio viene illustrato come creare e modificare una configurazione di sessione.

Nel primo comando viene utilizzato il cmdlet Register-PSSessionConfiguration per creare la configurazione AdminShell. 

Nel secondo comando viene utilizzato il cmdlet Set-PSSessionConfiguration per aggiungere lo script AdminConfig.ps1 alla configurazione. La modifica è effettiva quando si riavvia il servizio Gestione remota Windows.

Con il terzo comando viene rimosso lo script AdminConfig.ps1 dalla configurazione. Viene utilizzato il cmdlet Set-PSSessionConfiguration con un valore $null per il parametro 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

Descrizione
-----------
In questo esempio viene mostrato l'output di esempio per il cmdlet Set-PSSessionConfiguration. 

Il comando Set-PSSessionConfiguration in questo esempio consente di aumentare il valore della proprietà MaximumReceivedObjectSizeMB a 20. 

Il comando Set-PSSessionConfiguration restituisce un oggetto Microsoft.WSMan.Management.WSManConfigLeafElement che indica il nome del parametro e il nuovo valore.

Inoltre richiede all'utente di riavviare il servizio Gestione remota Windows. La modifica Set-PSSessionConfiguration non è effettiva finché il servizio Gestione remota Windows non viene riavviato.

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

Descrizione
-----------
Con questo comando vengono illustrati modi diversi per la visualizzazione dei risultati di un comando Set-PSSessionConfiguration.

Con il primo comando si utilizza il cmdlet Set-PSSessionConfiguration per modificare lo script di avvio nella configurazione MaintenanceShell in Sample.ps1. L'output di questo comando mostra la modifica e richiede all'utente di riavviare il servizio Gestione remota Windows. La risposta è "y" (sì).

Con il secondo comando si utilizza il cmdlet Get-PSSessionConfiguration per ottenere la configurazione di sessione MaintenanceShell. Con il comando si utilizza un operatore pipeline (|) per inviare i risultati del comando al cmdlet Format-List, in cui vengono visualizzate tutte le proprietà dell'oggetto configurazione di sessione in un elenco.

Con il terzo comando si utilizza il provider WS-Management per visualizzare i parametri di inizializzazione per la configurazione MaintenanceShell. Con il comando si utilizza il cmdlet Get-ChildItem (alias = dir) per ottenere gli elementi figlio nel nodo InitializationParameters per il plug-in MaintenanceShell.

Per ulteriori informazioni sul provider WS-Management, digitare "get-help wsman".