次の方法で共有

Set-PSSessionConfiguration

  • リファレンス
モジュール:
Microsoft.PowerShell.Core

登録済みのセッション構成のプロパティを変更します。

構文

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>]

説明

コマンドレットは Set-PSSessionConfiguration 、ローカル コンピューター上のセッション構成のプロパティを変更します。

Name パラメーターを使用して、変更するセッション構成を識別します。 その他のパラメーターは、セッション構成のプロパティに新しい値を指定するために使用します。 構成からプロパティ値を削除し、既定値を使用するには、対応するパラメーターに空の文字列 ("") または の $Null 値を入力します。

PowerShell 3.0 以降では、セッション構成ファイルを使用してセッション構成を定義できます。 この機能を使用すれば、セッション構成を使用するセッションのプロパティの設定や変更を迷わず簡単に実行できます。 セッション構成ファイルを指定するには、 の Path パラメーターを使用します Set-PSSessionConfiguration。 セッション構成ファイルの詳細については、「 about_Session_Configuration_Files」を参照してください。 セッション構成ファイルを作成および変更する方法については、 コマンドレットを New-PSSessionConfigurationFile 参照してください。

セッション構成では、ローカル コンピューターに接続するリモート セッション (PSSessions) の環境を定義します。 すべての PSSession はセッション構成を使用します。 セッション構成によって、セッションで使用可能なモジュール、実行が許可されるコマンドレット、言語モード、クォータ、タイムアウトなど、 PSSession の機能が決まります。 セッション構成のセキュリティ記述子によって、セッション構成を使用してローカル コンピューターに接続できるユーザーが決まります。 セッション構成の詳細については、「 about_Session_Configurations」を参照してください。

セッション構成のプロパティを表示するには、 コマンドレットまたは WSMan プロバイダーを使用 Get-PSSessionConfiguration します。 WSMan プロバイダーの詳細については、「」と入力します Get-Help WSMan。

例

例 1: スレッド アパートメントの状態を変更する

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

このコマンドは、MaintenanceShell 構成のスレッド アパートメント状態を STA に変更します。 この変更は、 WinRM サービスを再起動するときに有効です。

例 2: セッション構成をCreateして変更する

この例では、構成からスタートアップ スクリプトを追加および削除する方法を示します。

最初のコマンドは 、AdminShell 構成を作成します。 2 番目のコマンドは、スクリプトを AdminConfig.ps1 構成に追加します。 この変更は、 WinRM を再起動するときに有効です。 3 番目のコマンドは、 AdminConfig.ps1 構成からスクリプトを削除します。

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

例 3: 結果を表示する

次の使用例は、 MaximumReceivedObjectSizeMB プロパティの値を 20 に増やします。 このコマンドでは、 WinRM サービスの再起動を求めるメッセージも表示されます。 この変更は、 WinRM サービスが再起動されるまで有効ではありません。

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

例 4: さまざまな方法で結果を表示する

この例では、 Set-PSSessionConfigurationMaintenanceShell セッション構成のスタートアップ スクリプトを に Maintenance.ps1変更します。 出力には変更が表示され、 WinRM サービスを再起動するように求められます。 これに対する応答は "y" (はい) です。

Get-PSSessionConfiguration は MaintenanceShell セッション構成を取得します。 パイプライン演算子 (|) は、コマンドの結果を に Format-List送信します。これにより、構成オブジェクトのすべてのプロパティが一覧に表示されます。 次に、WSMan プロバイダーを使用して、 MaintenanceShell 構成の初期化パラメーターを表示します。 Get-ChildItem(別名dir)は、MaintenanceShell プラグインの InitializationParameters ノード内の子項目を取得します。 WSMan プロバイダーの詳細については、「」と入力します Get-Help wsman。

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

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       :

PS> dir WSMan:\localhost\Plugin\MaintenanceShell\InitializationParameters

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

パラメーター

-AccessMode

セッション構成を有効化および無効化し、コンピューター上のリモート セッションまたはローカル セッションにセッション構成を使用できるかどうかを決定します。 このパラメーターの有効値は、次のとおりです。

  • 無効。 セッション構成を無効にします。 コンピューターへのリモート アクセスまたはローカル アクセスに使用できません。 この値は、セッション構成 (WSMan:\<ComputerName>\PlugIn\<SessionConfigurationName>\Enabled) の Enabled プロパティを False に設定します。
  • Local。 Network_Deny_All エントリをセッション構成のセキュリティ記述子に追加します。 ローカル コンピューターのユーザーは、セッション構成を使用して同じコンピューターにローカル ループバック セッションを作成できますが、リモート ユーザーはアクセスを拒否されます。
  • [Remote]\(リモート\)。 Deny_All エントリと Network_Deny_All エントリをセッション構成のセキュリティ記述子から削除します。 ローカル コンピューターおよびリモート コンピューターのユーザーは、セッション構成を使用して、このコンピューターでセッションを作成し、コマンドを実行できます。

既定値は Remote です。

他のコマンドレットは、後でこのパラメーターの値をオーバーライドできます。 たとえば、 コマンドレットは Enable-PSRemoting コンピューター上のすべてのセッション構成を有効にし、それらに対するリモート アクセスを許可し Disable-PSRemoting 、コマンドレットはコンピューター上のすべてのセッション構成へのローカル アクセスのみを許可します。

このパラメーターは PowerShell 3.0 で導入されました。

Type:PSSessionConfigurationAccessMode
Accepted values:Disabled, Local, Remote
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ApplicationBase

AssemblyName パラメーターの値で指定されるアセンブリ ファイル (*.dll) のパスを指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AssemblyName

アセンブリ名を指定します。 このコマンドレットは、アセンブリで定義されているクラスに基づいてセッション構成を作成します。

セッション構成を定義するアセンブリ .dll ファイルのファイル名または完全パスを入力します。 ファイル名のみを入力する場合は、 ApplicationBase パラメーターの値にパスを入力できます。

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ConfigurationTypeName

AssemblyName パラメーターのアセンブリで定義されているセッションの構成の種類を指定します。 指定する型は、System.Management.Automation.Remoting.PSSessionConfiguration クラスを実装する必要があります。

アセンブリ名を指定する場合、このパラメーターは必須です。

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

すべてのユーザー プロンプトを抑制し、プロンプトを表示せずに WinRM サービスを再起動します。 サービスを再起動すると、構成の変更が有効になります。

再起動を回避し、再起動メッセージを表示しないようにするには、NoServiceRestart パラメーターを使用します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaximumReceivedDataSizePerCommandMB

任意の 1 つのリモート コマンドでこのコンピューターに送信できるデータの量の制限を指定します。 データ サイズはメガバイト (MB) 単位で入力します。 既定値は 50 MB です。

ConfigurationTypeName パラメーターで指定された構成の種類でデータ サイズの制限が定義されている場合は、構成の種類の制限が使用されます。 このパラメーターの値は無視されます。

Type:Double
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaximumReceivedObjectSizeMB

任意の 1 つのオブジェクトでこのコンピューターに送信できるデータの量の制限を指定します。 データ サイズをメガバイト単位で入力します。 既定値は 10 MB です。

ConfigurationTypeName パラメーターで指定されている構成の種類にオブジェクト サイズの制限が定義されている場合は、構成の種類の制限が使用されます。 このパラメーターの値は無視されます。

Type:Double
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ModulesToImport

セッション構成を使用するセッションに自動的にインポートされたモジュールおよびスナップインを指定します。 モジュール名およびスナップイン名を入力します。

既定では、 Microsoft.PowerShell.Core スナップインのみがセッションにインポートされますが、コマンドレットが除外されていない限り、 コマンドレットと Add-PSSnapin コマンドレットを使用 Import-Module して、モジュールとスナップインをセッションに追加できます。

このパラメーター値で指定されたモジュールは、セッション構成ファイル (New-PSSessionConfigurationFile) で指定されたモジュールに加えてインポートされます。 ただし、セッション構成ファイル内の設定によって、モジュールでエクスポートされたコマンドが非表示になったり、ユーザーが使用できなくなったりすることがあります。

このパラメーター値で指定されたモジュールは、コマンドレットの ModulesToImport パラメーターを使用して指定されたモジュールの一覧を Register-PSSessionConfiguration 置き換えます。

このパラメーターは PowerShell 3.0 で導入されました。

Type:Object[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

変更するセッション構成の名前を指定します。

このパラメーターを使用してセッション構成の名前を変更することはできません。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-NoServiceRestart

WinRM サービスを再起動せず、サービスを再起動するプロンプトを抑制します。

既定では、 を実行 Set-PSSessionConfigurationすると、新しいセッション構成を有効にするために WinRM サービスを再起動するように求められます。 WinRM サービスが再起動されるまで、新しいセッション構成は有効ではありません。

プロンプトを表示せずに WinRM サービスを再起動するには、 Force パラメーターを使用します。 WinRM サービスを手動で再起動するには、 コマンドレットを使用しますRestart-Service。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

コマンドレットによって作成されたものなど、セッション構成ファイル (.pssc) のパスを New-PSSessionConfigurationFile 指定します。 パスを省略した場合、既定値は現在のディレクトリになります。

セッション構成ファイルを変更する方法については、 コマンドレットのヘルプ トピックを New-PSSessionConfigurationFile 参照してください。

このパラメーターは PowerShell 3.0 で導入されました。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PSVersion

このセッション構成を使用するセッションの PowerShell のバージョンを指定します。

このパラメーターの値は、セッション構成ファイルの PowerShellVersion キーの値より優先されます。

このパラメーターは PowerShell 3.0 で導入されました。

Type:Version
Aliases:PowerShellVersion
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsCredential

セッション内のコマンドの資格情報を指定します。 既定では、コマンドは現在のユーザーのアクセス許可で実行されます。

このパラメーターは PowerShell 3.0 で導入されました。

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SecurityDescriptorSddl

構成に対して別のセキュリティ記述子定義言語 (SDDL) 文字列を指定します。

この文字列によって、新しいセッション構成を使用するために必要なアクセス許可が決定します。 セッションでセッション構成を使用するには、構成に対して少なくとも Execute(Invoke) 権限が必要です。

構成に既定のセキュリティ記述子を使用するには、空の文字列 ("") または 値 $Nullを入力します。 既定値は、WSMan: ドライブのルート SDDL です。

セキュリティ記述子が複雑な場合は、このパラメーターではなく ShowSecurityDescriptorUI パラメーターを使用することを検討してください。 両方のパラメーターを同じコマンドで使用することはできません。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SessionTypeOption

セッション構成の種類固有のオプションを指定します。 コマンドレットから返される PSWorkflowExecutionOption オブジェクトなど、セッションの種類のオプション オブジェクトを New-PSWorkflowExecutionOption 入力します。

セッション構成を使用するセッションのオプションは、セッション オプションの値とセッション構成オプションによって決定されます。 指定しない限り、コマンドレットを使用するなどしてセッションで設定されたオプションは New-PSSessionOption 、セッション構成で設定されたオプションよりも優先されます。 ただし、セッション オプションの値は、セッション構成に設定されている最大値を超えることはできません。

このパラメーターは PowerShell 3.0 で導入されました。

Type:PSSessionTypeOption
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ShowSecurityDescriptorUI

このコマンドレットが、セッション構成用の新しい SDDL を作成するのに役立つプロパティ シートであることを示します。 コマンドを実行し、WinRM サービスをSet-PSSessionConfiguration再起動すると、プロパティ シートが表示されます。

構成にアクセス許可を設定する場合、セッションでセッション構成を使用するには、ユーザーに少なくとも Execute(Invoke) アクセス許可が必要です。

SecurityDescriptorSDDL パラメーターとこのパラメーターを同じコマンドで使用することはできません。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StartupScript

構成のスタートアップ スクリプトを指定します。 PowerShell スクリプトの完全修飾パスを入力します。 指定されたスクリプトが、セッション構成を使用する新しいセッションで実行されます。

セッション構成からスタートアップ スクリプトを削除するには、空の文字列 ("") または 値 $Nullを入力します。

スタートアップ スクリプトを使用して、ユーザー セッションをさらに構成できます。 スクリプトで終了しないエラーであってもエラーが生成された場合、セッションは作成されず、コマンドは New-PSSession 失敗します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ThreadApartmentState

セッション内のスレッドのアパートメント状態設定を指定します。 このパラメーターに使用できる値は、STA、MTA、および Unknown です。 既定値は Unknown です。

Type:ApartmentState
Accepted values:STA, MTA, Unknown
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ThreadOptions

構成のスレッド オプション設定を指定します。 この設定は、セッションでコマンドが実行されたときのスレッドの作成方法および使用方法を定義します。 このパラメーターの有効値は、次のとおりです。

  • Default
  • ReuseThread
  • UseCurrentThread
  • UseNewThread

既定値は UseCurrentThread です。

詳細については、「 PSThreadOptions 列挙」を参照してください。

Type:PSThreadOptions
Accepted values:Default, UseNewThread, ReuseThread, UseCurrentThread
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TransportOption

セッション構成のトランスポート オプションを指定します。 コマンドレットから返される WSManConfigurationOption オブジェクトなどのトランスポート オプション オブジェクトを New-PSTransportOption 入力します。

セッション構成を使用するセッションのオプションは、セッション オプションの値とセッション構成オプションによって決定されます。 指定しない限り、コマンドレットを使用するなどしてセッションで設定されたオプションは New-PSSessionOption 、セッション構成で設定されたオプションよりも優先されます。 ただし、セッション オプションの値は、セッション構成に設定されている最大値を超えることはできません。

このパラメーターは PowerShell 3.0 で導入されました。

Type:PSTransportOption
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseSharedProcess

同じユーザーによって開始されたすべてのセッションをホストし、同じセッション構成を使用するには、1 つのプロセスのみを使用します。 既定では、各セッションは、個別のプロセスでホストされます。

このパラメーターは PowerShell 3.0 で導入されました。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

None

パイプを使用してこのコマンドレットに入力を渡すことはできません。

出力

WSManConfigLeafElement

メモ

このコマンドレットを実行するには、[管理者として実行] オプションを使用して PowerShell を起動します。

コマンドレットは Set-PSSessionConfiguration 構成名を変更せず、 WSMan プロバイダーは コマンドレットを Rename-Item サポートしていません。 セッション構成の名前を変更するには、 コマンドレットを Unregister-PSSessionConfiguration 使用して構成を削除し、 コマンドレットを Register-PSSessionConfiguration 使用して新しいセッション構成を作成して登録します。

コマンドレットを Set-PSSessionConfiguration 使用して、既定の Microsoft.PowerShell および Microsoft.PowerShell32 セッション構成を変更できます。 これらの構成は保護されません。 既定のセッション構成の元のバージョンに戻すには、 コマンドレットを Unregister-PSSessionConfiguration 使用して既定のセッション構成を削除してから、 コマンドレットを Enable-PSRemoting 使用して復元します。

セッション構成オブジェクトのプロパティは、セッション構成に設定されているオプションとその値によって異なります。 また、セッション構成ファイルを使用するセッション構成には追加のプロパティがあります。

WSMan: ドライブでコマンドを使用して、セッション構成のプロパティを変更できます。 ただし、PowerShell 2.0 の WSMan: ドライブを使用して、PowerShell 3.0 で導入されたセッション構成プロパティ ( OutputBufferingMode など) を変更することはできません。 Windows PowerShell 2.0 のコマンドではエラーは生成されませんが、効果はありません。 PowerShell 3.0 で導入されたプロパティを変更するには、PowerShell 3.0 の WSMan: ドライブを使用します。