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

Descrição
-----------
Esse comando altera o estado apartment do thread na configuração MaintenanceShell para STA. A alteração entra em vigor quando você reinicia o serviço 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

Descrição
-----------
Este exemplo mostra como criar e, em seguida, alterar uma configuração de sessão.

O primeiro comando usa o cmdlet Register-PSSessionConfiguration para criar a configuração AdminShell. 

O segundo comando usa o cmdlet Set-PSSessionConfiguration para adicionar o script AdminConfig.ps1 à configuração. A alteração entra em vigor quando você reinicia o WinRM.

O terceiro comando remove o script AdminConfig.ps1 da configuração. Ele usa o cmdlet Set-PSSessionConfiguration com um valor $null para o 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

Descrição
-----------
Este exemplo mostra a saída de exemplo do cmdlet Set-PSSessionConfiguration. 

O comando Set-PSSessionConfiguration neste exemplo aumenta o valor da propriedade MaximumReceivedObjectSizeMB para 20. 

O comando Set-PSSessionConfiguration retorna um objeto Microsoft.WSMan.Management.WSManConfigLeafElement que mostra o nome do parâmetro e o novo valor.

Ele também solicita o reinício do serviço WinRM. A alteração de Set-PSSessionConfiguration não entra em vigor até o serviço WinRM ser reiniciado.

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

Descrição
-----------
Esse comando mostra diferentes modos de exibir os resultados de um comando Set-PSSessionConfiguration.

O primeiro comando usa o cmdlet Set-PSSessionConfiguration para alterar o script de inicialização na configuração MaintenanceShell para Maintenance.ps1. A saída desse comando mostra a alteração e solicita que você reinicie o serviço WinRM. A resposta é "y" (sim).

O segundo comando usa o cmdlet Get-PSSessionConfiguration para obter a configuração de sessão MaintenanceShell. O comando usa um operador de pipeline (|) para enviar os resultados do comando para o cmdlet Format-List, que exibe todas as propriedades do objeto de configuração de sessão em uma lista.

O terceiro comando usa o provedor de WS-Management para exibir os parâmetros de inicialização para a configuração MaintenanceShell. O comando usa o cmdlet Get-ChildItem (alias = dir) para obter os itens filho no nó InitializationParameters para o plug-in MaintenanceShell.

Para obter mais informações sobre o provedor de WS-Management, digite "get-help wsman".