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

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

説明
-----------
このコマンドは、MaintenanceShell 構成のスレッド アパートメント状態を STA に変更します。変更は、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

説明
-----------
この例は、セッション構成を作成して変更する方法を示しています。

最初のコマンドは、Register-PSSessionConfiguration コマンドレットを使用して AdminShell 構成を作成します。

2 番目のコマンドは、Set-PSSessionConfiguration コマンドレットを使用して、AdminConfig.ps1 スクリプトを構成に追加します。変更は、WinRM を再起動したときに有効になります。

3 番目のコマンドは、構成から AdminConfig.ps1 スクリプトを削除します。このコマンドは、StartupScript パラメーターに $null の値が指定された Set-PSSessionConfiguration コマンドレットを使用します。

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

説明
-----------
この例は、Set-PSSessionConfiguration コマンドレットからのサンプル出力を示しています。

この例の Set-PSSessionConfiguration コマンドは、MaximumReceivedObjectSizeMB プロパティの値を 20 に増加します。

Set-PSSessionConfiguration コマンドは、パラメーター名および新しい値を表示する Microsoft.WSMan.Management.WSManConfigLeafElement オブジェクトを返します。

WinRM サービスの再起動を求めるメッセージも表示されます。Set-PSSessionConfiguration の変更は、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

説明
-----------
このコマンドは、Set-PSSessionConfiguration コマンドの結果を表示するさまざまな方法を示します。

最初のコマンドは、Set-PSSessionConfiguration コマンドレットを使用して、MaintenanceShell 構成のスタートアップ スクリプトを Maintenance.ps1 に変更します。このコマンドの出力は変更を示し、WinRM サービスの再起動を求めるメッセージを表示します。これに対する応答は「y」(はい) です。

2 番目のコマンドは、Get-PSSessionConfiguration コマンドレットを使用して、MaintenanceShell セッション構成を取得します。このコマンドは、パイプライン演算子 (|) を使用してコマンドの結果を Format-List コマンドレットに送信し、セッション構成オブジェクトのすべてのプロパティを一覧表示します。

3 番目のコマンドは、WS-Management プロバイダーを使用して、MaintenanceShell 構成の初期化パラメーターを表示します。このコマンドは、Get-ChildItem コマンドレット (エイリアス = dir) を使用して、MaintenanceShell プラグインの InitializationParameters ノードの子項目を取得します。

WS-Management プロバイダーの詳細については、「get-help wsman」と入力してください。