Enable-PSSessionConfiguration

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

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

構文

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 と 管理Shell セッション構成を再度有効にします。

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 セキュリティ記述子からすべての拒否項目のみが削除されます。

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

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

String

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

出力

None

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

メモ

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

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