次の方法で共有

Disable-PSSessionConfiguration

モジュール:
Microsoft.PowerShell.Core Module

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

構文

Default (既定) 

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

説明

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

PowerShell 3.0 以降、Disable-PSSessionConfiguration コマンドレットは、セッション構成 () の WSMan:\localhost\Plugins\<SessionConfiguration>\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
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Force

ユーザーの確認を求めずにコマンドを強制的に実行します。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Name

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

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

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:True
DontShow:False

パラメーター セット

(All)
配置:0
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-NoServiceRestart

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

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:ウィスコンシン

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

入力

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands

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

String

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

出力

None

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

メモ

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