次の方法で共有

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 と 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-PSSessionConfigurationMicrosoft.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

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

String

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

出力

None

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

メモ

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

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