Enable-PSSessionConfiguration
ローカル コンピューター上のセッション構成を有効にします。
構文
Enable-PSSessionConfiguration
[[-Name] <String[]>]
[-Force]
[-SecurityDescriptorSddl <String>]
[-SkipNetworkProfileCheck]
[-NoServiceRestart]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
このコマンドレットは、Windows プラットフォームでのみ使用できます。
コマンドレットをEnable-PSSessionConfiguration
使用すると、 コマンドレットや Disable-PSRemoting
の AccessMode パラメーターRegister-PSSessionConfiguration
を使用Disable-PSSessionConfiguration
するなど、無効になっている登録済みのセッション構成が有効になります。 これは、ユーザーに応じてカスタマイズされたセッション構成を管理するために、システム管理者向けに設計された高度なコマンドレットです。
パラメーターを指定しないと、 Enable-PSSessionConfiguration
セッションに使用される既定の構成である Microsoft.PowerShell 構成が有効になります。
Enable-PSSessionConfiguration
は、影響を受けるセッション構成のセキュリティ記述子から Deny_All 設定を削除し、任意の IP アドレスで要求を受け入れるリスナーをオンにして、WinRM サービスを再起動します。 PowerShell 3.0 以降では、Enable-PSSessionConfiguration
セッション構成 (WSMan:\<computer>\PlugIn\<SessionConfigurationName>\Enabled
) の 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
コマンドレットの実行前に確認を求めるメッセージが表示されます。
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 |
-Name
有効にするセッション構成の名前を指定します。 1 つまたは複数の構成名を入力します。 ワイルドカード文字を使用できます。
構成名またはセッション構成オブジェクトを含む文字列を に Enable-PSSessionConfiguration
パイプすることもできます。
このパラメーターを省略すると、 Enable-PSSessionConfiguration
Microsoft.PowerShell セッション構成が有効になります。
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-NoServiceRestart
コマンドレットがサービスを再起動しないことを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecurityDescriptorSddl
このコマンドレットがセッション構成のセキュリティ記述子を置き換えるセキュリティ記述子を指定します。
このパラメーターを省略すると、 Enable-PSSessionConfiguration
セキュリティ記述子から deny all 項目のみが削除されます。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipNetworkProfileCheck
コンピューターがパブリック ネットワーク上にある場合に、このコマンドレットでセッション構成を有効にすることを示します。 このパラメーターは、同じローカル サブネット内のコンピューターに対してのみリモート アクセスを許可する、パブリック ネットワークのファイアウォール規則を有効にします。 既定では、 Enable-PSSessionConfiguration
はパブリック ネットワークで失敗します。
このパラメーターは、Windows オペレーティング システムのクライアント バージョン向けに設計されています。 Windows オペレーティング システムのサーバー バージョンには、パブリック ネットワーク用のローカル サブネット ファイアウォール規則があります。 ただし、ローカル サブネットのファイアウォール規則が Windows オペレーティング システムのサーバー バージョンで無効になっている場合は、このパラメーターを再び有効にします。
ローカル サブネットの制限を削除し、パブリック ネットワーク上のすべての場所からリモート アクセスを有効にするには、NetSecurity モジュールの コマンドレットを使用 Set-NetFirewallRule
します。 詳細については、「Enable-PSRemoting
」を参照してください。
このパラメーターは、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 |
入力
Microsoft.PowerShell.Commands.PSSessionConfigurationCommands
セッション構成オブジェクトをこのコマンドレットにパイプできます。
セッション構成の名前を含む文字列をこのコマンドレットにパイプできます。
出力
None
このコマンドレットは、出力を返しません。
メモ
このコマンドレットは、Windows プラットフォームでのみ使用できます。
このコマンドレットを使用するには、[ 管理者として実行 ] オプションを使用して PowerShell を起動する必要があります。
関連リンク
- Disable-PSSessionConfiguration
- Get-PSSessionConfiguration
- New-PSSessionConfigurationFile
- New-PSSessionOption
- Register-PSSessionConfiguration
- Set-PSSessionConfiguration
- Test-PSSessionConfigurationFile
- Unregister-PSSessionConfiguration
- WSMan プロバイダー
- about_Session_Configurations
- about_Session_Configuration_Files