Disable-PSSessionConfiguration

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

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

構文

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

説明

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

このコマンドレットは 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 と 管理Shell セッションの構成を無効にします。 パイプライン演算子 (|) は、 Get-PSSessionConfiguration a の結果を送信します 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

Note

構成を無効にしても、コマンドレットを使用して Set-PSSessionConfiguration 構成を変更することはできません。 構成の使用のみが禁止されます。

パラメーター

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

ユーザーに確認せずに、直ちにコマンドを実行します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

無効にするセッション構成の名前の配列を指定します。 1 つまたは複数の構成名を入力します。 ワイルドカード文字を使用できます。 構成名またはセッション構成オブジェクト Disable-PSSessionConfigurationを含む文字列をパイプすることもできます。

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

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-NoServiceRestart

WSMan サービスの再起動を防ぐために使用されます。 構成を無効にするためにサービスを再起動する必要はありません。

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 を起動する必要があります。