次の方法で共有

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 および 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

Note

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

パラメーター

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Force

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

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

このパラメーターを省略した場合、 Disable-PSSessionConfiguration は Microsoft.PowerShell セッション構成を無効にします。

型:String[]
配置:0
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:True

-NoServiceRestart

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

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

String

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

出力

None

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

メモ

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

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