次の方法で共有

Disable-PSSessionConfiguration

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

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

構文

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

手記

構成を無効にしても、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

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

メモ

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