Enable-PSSessionConfiguration

リファレンス

モジュール:: Microsoft.PowerShell.Core

ローカルコンピューターでセッション構成を有効にします。

構文

Enable-PSSessionConfiguration
      [[-Name] <String[]>]
      [-Force]
      [-SecurityDescriptorSddl <String>]
      [-SkipNetworkProfileCheck]
      [-NoServiceRestart]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

このコマンドレットは、Windows プラットフォームでのみ使用できます。

Enable-PSSessionConfiguration コマンドレットを使用すると、Disable-PSSessionConfiguration または Disable-PSRemoting コマンドレットの使用、または Register-PSSessionConfigurationの AccessMode パラメーターなど、無効にされた登録済みセッション構成が有効になります。これは、ユーザーのカスタマイズされたセッション構成を管理するためにシステム管理者が使用するように設計された高度なコマンドレットです。

パラメーターがない場合、Enable-PSSessionConfiguration では、セッションに使用される既定の構成である Microsoft.PowerShell 構成が有効になります。

Enable-PSSessionConfiguration、影響を受けるセッション構成のセキュリティ記述子から Deny_All 設定を削除し、任意の IP アドレスで要求を受け入れるリスナーを有効にして、WinRM サービスを再起動します。 PowerShell 3.0 以降では、Enable-PSSessionConfiguration セッション構成の Enabled プロパティ (WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled) の値も True に設定されます。ただし、Enable-PSSessionConfiguration では、ローカルコンピューターのユーザーのみがセッション構成に使用できる Network_Deny_All (AccessMode=Local) セキュリティ記述子設定は削除または変更されません。

例

例 1: 既定のセッションを再度有効にする

この例では、コンピューターの既定のセッション構成 Microsoft.PowerShell を再度有効にします。

Enable-PSSessionConfiguration

例 2: 指定したセッションを再度有効にする

この例では、MaintenanceShell を再度有効にし、コンピューター上の AdminShell セッション構成を します。

Enable-PSSessionConfiguration -Name MaintenanceShell, AdminShell

例 3: すべてのセッションを再度有効にする

この例では、コンピューター上のすべてのセッション構成を再度有効にします。これらのコマンドは同等です。そのため、いずれかを使用できます。

Enable-PSSessionConfiguration -Name *
Get-PSSessionConfiguration | Enable-PSSessionConfiguration

既に有効になっているセッション構成を有効にした場合、Enable-PSSessionConfiguration はエラーを生成しません。

例 4: セッションを再度有効にして、新しいセキュリティ記述子を指定する

この例では、MaintenanceShell セッション構成を再度有効にし、構成の新しいセキュリティ記述子を指定します。

$sddl = "O:NSG:BAD:P(A;;GXGWGR;;;BA)(A;;GAGR;;;S-1-5-21-123456789-188441444-3100496)S:P"
Enable-PSSessionConfiguration -Name MaintenanceShell -SecurityDescriptorSDDL $sddl

パラメーター

-Confirm

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

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Force

コマンドレットが確認を求めず、プロンプトを表示せずに WinRM サービスを再起動することを示します。サービスを再起動すると、構成の変更が有効になります。

再起動を防ぎ、再起動プロンプトを表示しないようにするには、NoServiceRestart パラメーターを使用します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Name

有効にするセッション構成の名前を指定します。 1 つ以上の構成名を入力します。ワイルドカード文字を使用できます。

構成名またはセッション構成オブジェクトを含む文字列をパイプ処理して、Enable-PSSessionConfigurationすることもできます。

このパラメーターを省略 Enable-PSSessionConfiguration、Microsoft.PowerShell セッション構成が有効になります。

型:	String[]
配置:	0
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	True

-NoServiceRestart

コマンドレットがサービスを再起動しないことを示します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SecurityDescriptorSddl

このコマンドレットがセッション構成のセキュリティ記述子を置き換えるセキュリティ記述子を指定します。

このパラメーターを省略した場合、Enable-PSSessionConfiguration は、セキュリティ記述子からすべての拒否項目のみを削除します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-SkipNetworkProfileCheck

コンピューターがパブリックネットワーク上にある場合に、このコマンドレットでセッション構成を有効にすることを示します。このパラメーターは、同じローカルサブネット内のコンピューターからのリモートアクセスのみを許可するパブリックネットワークのファイアウォール規則を有効にします。既定では、Enable-PSSessionConfiguration はパブリックネットワークで失敗します。

このパラメーターは、Windows オペレーティングシステムのクライアントバージョン用に設計されています。 Windows オペレーティングシステムのサーバーバージョンには、パブリックネットワーク用のローカルサブネットファイアウォール規則があります。ただし、Windows オペレーティングシステムのサーバーバージョンでローカルサブネットのファイアウォール規則が無効になっている場合は、このパラメーターを再度有効にします。

ローカルサブネットの制限を削除し、パブリックネットワーク上のすべての場所からリモートアクセスを有効にするには、NetSecurity モジュールの Set-NetFirewallRule コマンドレットを使用します。詳細については、Enable-PSRemotingを参照してください。

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

コマンドレットを実行した場合の動作を示します。コマンドレットは実行されません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

セッション構成オブジェクトをこのコマンドレットにパイプできます。

String

セッション構成の名前を含む文字列をこのコマンドレットにパイプできます。

出力

None

このコマンドレットは出力を返しません。

メモ

このコマンドレットは、Windows プラットフォームでのみ使用できます。

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