Set-PSSessionConfiguration

Sintaxe

Set-PSSessionConfiguration
   [-Name] <String>
   [-ApplicationBase <String>]
   [-RunAsCredential <PSCredential>]
   [-ThreadApartmentState <ApartmentState>]
   [-ThreadOptions <PSThreadOptions>]
   [-AccessMode <PSSessionConfigurationAccessMode>]
   [-UseSharedProcess]
   [-StartupScript <String>]
   [-MaximumReceivedDataSizePerCommandMB <Double>]
   [-MaximumReceivedObjectSizeMB <Double>]
   [-SecurityDescriptorSddl <String>]
   [-ShowSecurityDescriptorUI]
   [-Force]
   [-NoServiceRestart]
   [-PSVersion <Version>]
   [-SessionTypeOption <PSSessionTypeOption>]
   [-TransportOption <PSTransportOption>]
   [-ModulesToImport <Object[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-PSSessionConfiguration
   [-Name] <String>
   [-AssemblyName] <String>
   [-ApplicationBase <String>]
   [-ConfigurationTypeName] <String>
   [-RunAsCredential <PSCredential>]
   [-ThreadApartmentState <ApartmentState>]
   [-ThreadOptions <PSThreadOptions>]
   [-AccessMode <PSSessionConfigurationAccessMode>]
   [-UseSharedProcess]
   [-StartupScript <String>]
   [-MaximumReceivedDataSizePerCommandMB <Double>]
   [-MaximumReceivedObjectSizeMB <Double>]
   [-SecurityDescriptorSddl <String>]
   [-ShowSecurityDescriptorUI]
   [-Force]
   [-NoServiceRestart]
   [-PSVersion <Version>]
   [-SessionTypeOption <PSSessionTypeOption>]
   [-TransportOption <PSTransportOption>]
   [-ModulesToImport <Object[]>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-PSSessionConfiguration
   [-Name] <String>
   [-RunAsCredential <PSCredential>]
   [-ThreadApartmentState <ApartmentState>]
   [-ThreadOptions <PSThreadOptions>]
   [-AccessMode <PSSessionConfigurationAccessMode>]
   [-UseSharedProcess]
   [-StartupScript <String>]
   [-MaximumReceivedDataSizePerCommandMB <Double>]
   [-MaximumReceivedObjectSizeMB <Double>]
   [-SecurityDescriptorSddl <String>]
   [-ShowSecurityDescriptorUI]
   [-Force]
   [-NoServiceRestart]
   [-TransportOption <PSTransportOption>]
   -Path <String>
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O Set-PSSessionConfiguration cmdlet altera as propriedades das configurações de sessão no computador local.

Use o parâmetro Name para identificar a configuração da sessão que você deseja alterar. Use os outros parâmetros para especificar novos valores para as propriedades da configuração de sessão. Para excluir um valor de propriedade da configuração e usar o valor padrão, insira uma string vazia ("") ou um valor de $Null para o parâmetro correspondente.

A partir do PowerShell 3.0, você pode usar um arquivo de configuração de sessão para definir uma configuração de sessão. Esse recurso fornece um método simples e detectável para definir ou alterar as propriedades de sessões que usam a configuração de sessão. Para especificar um arquivo de configuração de sessão, use o parâmetro Path de Set-PSSessionConfiguration. Para obter informações sobre arquivos de configuração de sessão, consulte about_Session_Configuration_Files. Para obter informações sobre como criar e modificar um arquivo de configuração de sessão, consulte o New-PSSessionConfigurationFile cmdlet.

As configurações de sessão definem o ambiente de sessões remotas (PSSessions) que se conectam ao computador local. Cada PSSession usa uma configuração de sessão. A configuração da sessão determina os recursos do PSSession, como os módulos que estão disponíveis na sessão, os cmdlets que têm permissão para serem executados, o modo de idioma, cotas e tempos limite. O descritor de segurança da configuração da sessão determina quem pode usar a configuração da sessão para se conectar ao computador local. Para saber mais sobre configurações de sessão, confira about_Session_Configurations.

Para ver as propriedades de uma configuração de sessão, use o Get-PSSessionConfiguration cmdlet ou o Provedor WSMan. Para obter mais informações sobre o Provedor WSMan, digite Get-Help WSMan.

Exemplos

Exemplo 1: Alterar o estado do apartamento do thread

PS C:\> Set-PSSessionConfiguration -Name "MaintenanceShell" -ThreadApartmentState STA

Esse comando altera o estado de apartment do thread na configuração MaintenanceShell para STA. A alteração entra em vigor quando você reinicia o serviço WinRM .

Exemplo 2: Criar e alterar uma configuração de sessão

Este exemplo mostra como adicionar e remover um script de inicialização de uma configuração.

O primeiro comando cria a configuração do AdminShell . O segundo comando adiciona o AdminConfig.ps1 script à configuração. A alteração entra em vigor quando você reinicia o WinRM. O terceiro comando remove o AdminConfig.ps1 script da configuração.

Register-PSSessionConfiguration -Name "AdminShell" -AssemblyName "C:\Shells\AdminShell.dll" -ConfigurationTypeName "AdminClass"
Set-PSSessionConfiguration -Name "AdminShell" -StartupScript "AdminConfig.ps1"
Set-PSSessionConfiguration -Name "AdminShell" -StartupScript $Null

Exemplo 3: Exibir resultados

Este exemplo aumenta o valor da propriedade MaximumReceivedObjectSizeMB para 20. Esse comando também solicita que você reinicie o serviço WinRM . A alteração não entra em vigor até que o serviço WinRM seja reiniciado.

Set-PSSessionConfiguration -Name "IncObj" -MaximumReceivedObjectSizeMB 20

WSManConfig: Microsoft.WSMan.Management\WSMan::localhost\Plugin\IncObj\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

Exemplo 3: Exibir resultados de maneiras diferentes

Neste exemplo, Set-PSSessionConfiguration o altera o script de inicialização na configuração da sessão do MaintenanceShell para Maintenance.ps1. A saída mostra a alteração e solicita que você reinicie o serviço WinRM . A resposta é y (sim).

Get-PSSessionConfiguration obtém a configuração da sessão do MaintenanceShell . O operador de pipeline (|) envia os resultados do comando para Format-List, que exibe todas as propriedades do objeto de configuração em uma lista. Em seguida, usando o provedor WSMan, exibimos os parâmetros de inicialização para a configuração do MaintenanceShell . Get-ChildItem obtém os itens filho no nó InitializationParameters para o plug-in MaintenanceShell . Para obter mais informações sobre o provedor WSMan, digite Get-Help wsman.

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

Get-PSSessionConfiguration MaintenanceShell | Format-List -Property *

xmlns            : http://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      : http://schemas.microsoft.com/powershell/MaintenanceShell
SupportsOptions  : true
ExactMatch       : true
Capability       : {Shell}
Permission       :

Get-ChildItem WSMan:\localhost\Plugin\MaintenanceShell\InitializationParameters

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

Parâmetros

-AccessMode

-ApplicationBase

-AssemblyName

-ConfigurationTypeName

-Confirm

-Force

-MaximumReceivedDataSizePerCommandMB

-MaximumReceivedObjectSizeMB

-ModulesToImport

-Name

-NoServiceRestart

-Path

-PSVersion

-RunAsCredential

-SecurityDescriptorSddl

-SessionTypeOption

-ShowSecurityDescriptorUI

-StartupScript

-ThreadApartmentState

-ThreadOptions

-TransportOption

-UseSharedProcess

-WhatIf

Entradas

None

Você não pode canalizar objetos para esse cmdlet.

Saídas

WSManConfigLeafElement

Observações

Para executar esse cmdlet, inicie o PowerShell usando a opção Executar como administrador .

O Set-PSSessionConfiguration cmdlet não altera o nome da configuração e o provedor WSMan não dá suporte ao Rename-Item cmdlet. Para alterar o nome de uma configuração de sessão, use o Unregister-PSSessionConfiguration cmdlet para excluir a configuração e, em seguida, use o Register-PSSessionConfiguration cmdlet para criar e registrar uma nova configuração de sessão.

Você pode usar o Set-PSSessionConfiguration cmdlet para alterar as configurações padrão Microsoft.PowerShell e Microsoft.PowerShell32 de sessão. Elas não são protegidas. Para reverter para a versão original de uma configuração de sessão padrão, use o Unregister-PSSessionConfiguration cmdlet para excluir a configuração de sessão padrão e, em seguida, use o Enable-PSRemoting cmdlet para restaurá-la.

As propriedades de um objeto de configuração de sessão variam de acordo com as opções definidas para a configuração da sessão e os valores dessas opções. Além disso, as configurações de sessão que usam um arquivo de configuração de sessão têm propriedades adicionais.

Você pode usar comandos na WSMan: unidade para alterar as propriedades das configurações da sessão. No entanto, você não pode usar a unidade no PowerShell 2.0 para alterar as WSMan: propriedades de configuração de sessão introduzidas no PowerShell 3.0, como OutputBufferingMode. Os comandos do Windows PowerShell 2.0 não geram um erro, mas são ineficazes. Para alterar as propriedades introduzidas no PowerShell 3.0, use a WSMan: unidade no PowerShell 3.0 ou posterior.

Links Relacionados

• Disable-PSSessionConfiguration
• Disable-PSSessionConfiguration
• Get-PSSessionConfiguration
• New-PSSessionConfigurationFile
• New-PSSessionOption
• New-PSTransportOption
• New-PSWorkflowExecutionOption
• Register-PSSessionConfiguration
• Test-PSSessionConfigurationFile
• Unregister-PSSessionConfiguration
• Provedor WSMan
• about_Session_Configurations
• about_Session_Configuration_Files