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

Descripción
-----------
Este comando cambia a STA el estado del apartamento de subproceso en la configuración MaintenanceShell. El cambio surte efecto al reiniciar el servicio 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

Descripción
-----------
En este ejemplo se muestra cómo crear y cambiar, a continuación, una configuración de sesión.

El primer comando utiliza el cmdlet Register-PSSessionConfiguration para crear la configuración AdminShell. 

El segundo comando utiliza el cmdlet Set-PSSessionConfiguration para agregar el script AdminConfig.ps1 a la configuración. El cambio surte efecto al reiniciar WinRM.

El tercer comando quita el script AdminConfig.ps1 de la configuración. Utiliza el cmdlet Set-PSSessionConfiguration con el valor $null en el parámetro 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

Descripción
-----------
En este ejemplo se muestra un ejemplo de resultados del cmdlet Set-PSSessionConfiguration. 

El comando Set-PSSessionConfiguration de este ejemplo aumenta el valor de la propiedad MaximumReceivedObjectSizeMB a 20. 

El comando Set-PSSessionConfiguration devuelve un objeto Microsoft.WSMan.Management.WSManConfigLeafElement que muestra el nombre del parámetro y su nuevo valor.

También solicita al usuario que reinicie el servicio WinRM. El cambio de Set-PSSessionConfiguration no surte efecto hasta que se reinicia el servicio WinRM.

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

Descripción
-----------
Este comando muestra maneras diferentes de ver los resultados de un comando Set-PSSessionConfiguration.

El primer comando utiliza el cmdlet Set-PSSessionConfiguration para cambiar a Maintenance.ps1 el script de inicio de la configuración MaintenanceShell. El resultado de este comando muestra el cambio y solicita al usuario que reinicie el servicio WinRM. La respuesta es "y" (sí).

El segundo comando utiliza el cmdlet Get-PSSessionConfiguration para obtener la configuración de sesión MaintenanceShell. El comando utiliza un operador de canalización (|) para enviar el resultado del comando al cmdlet Format-List, que muestra en una lista todas las propiedades del objeto de configuración de sesión.

El tercer comando utiliza el proveedor WS-Management para ver los parámetros de inicialización de la configuración MaintenanceShell. El comando utiliza el cmdlet Get-ChildItem (alias = dir) para obtener los elementos secundarios del nodo InitializationParameters para el complemento MaintenanceShell.

Para obtener más información acerca del proveedor WS-Management, escriba "get-help wsman".