Disable-PSSessionConfiguration

構文

Disable-PSSessionConfiguration
       [[-Name] <String[]>]
       [-Force]
       [-NoServiceRestart]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

説明

Disable-PSSessionConfiguration コマンドレットは、ローカル コンピューター上のセッション構成を無効にします。これにより、すべてのユーザーがセッション構成を使用してローカル コンピューター上にユーザー管理セッション (PSSessions) を作成できなくなります。 これは、ユーザーに応じてカスタマイズされたセッション構成を管理するために、システム管理者向けに設計された高度なコマンドレットです。

PowerShell 3.0 以降、Disable-PSSessionConfiguration コマンドレットは、セッション構成 (WSMan:\localhost\Plugins\<SessionConfiguration>\Enabled) の Enabled 設定を False に設定します。

PowerShell 2.0 では、 Disable-PSSessionConfiguration コマンドレットは、1 つ以上の登録済みセッション構成のセキュリティ記述子に Deny_All エントリを追加します。

パラメーターを指定しない場合、 Disable-PSSessionConfiguration はセッションに使用される既定の構成である Microsoft.PowerShell 構成を無効にします。 ユーザーが別の構成を指定していない限り、ローカル ユーザーとリモート ユーザーの両方がコンピューターに接続するセッションをできないように、効果的に防ぐことができます。

コンピューター上のすべてのセッション構成を無効にするには、 Disable-PSRemotingを使用します。

例

例 1: 既定の構成を無効にする

この例では、 Microsoft.PowerShell セッション構成を無効にします。

Disable-PSSessionConfiguration

例 2: 登録されているすべてのセッション構成を無効にする

この例では、コンピューターに登録されているすべてのセッション構成を無効にします。

Disable-PSSessionConfiguration -Name *

例 3: 名前でセッション構成を無効にする

この例では、 Microsoftで始まる名前を持つすべてのセッション構成を無効にします。 Force パラメーターは、コマンドレットからのすべてのユーザー プロンプトを抑制します。

Disable-PSSessionConfiguration -Name Microsoft* -Force

例 4: パイプラインを使用してセッション構成を無効にする

この例では、 MaintenanceShell および AdminShell セッション構成を無効にします。 パイプライン演算子 (|) は、 Get-PSSessionConfiguration の結果を Disable-PSSessionConfigurationに送信します。

Get-PSSessionConfiguration -Name MaintenanceShell, AdminShell | Disable-PSSessionConfiguration

例 5: セッション構成を無効にした場合の影響

この例では、 Disable-PSSessionConfiguration の実行前後のアクセス許可と、セッション構成を無効にした場合の影響を示します。

PS> Get-PSSessionConfiguration | Format-Table -Property Name, Permission -Auto

Name                   Permission
----                   ----------
MaintenanceShell       BUILTIN\Administrators AccessAllowed
microsoft.powershell   BUILTIN\Administrators AccessAllowed
microsoft.powershell32 BUILTIN\Administrators AccessAllowed

PS> Disable-PSSessionConfiguration -Name MaintenanceShell -Force
PS> Get-PSSessionConfiguration | Format-Table -Property Name, Permission -Auto

Name                   Permission
----                   ----------
MaintenanceShell       Everyone AccessDenied, BUILTIN\Administrators AccessAllowed
microsoft.powershell   BUILTIN\Administrators AccessAllowed
microsoft.powershell32 BUILTIN\Administrators AccessAllowed

PS> New-PSSession -ComputerName localhost -ConfigurationName MaintenanceShell

[localhost] Connecting to remote server failed with the following error message : Access is denied.
For more information, see the about_Remote_Troubleshooting Help topic.
+ CategoryInfo          : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
+ FullyQualifiedErrorId : PSSessionOpenFailed

パラメーター

-Confirm

-Force

-Name

-NoServiceRestart

-WhatIf

入力

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

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

String

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

出力

None

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

メモ

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

関連リンク

• Enable-PSSessionConfiguration
• Get-PSSessionConfiguration
• New-PSSessionConfigurationFile
• Register-PSSessionConfiguration
• Set-PSSessionConfiguration
• Test-PSSessionConfigurationFile
• Unregister-PSSessionConfiguration
• WSMan プロバイダー
• about_Session_Configurations
• about_Session_Configuration_Files