Disable-PSSessionConfiguration

Disable-PSSessionConfiguration [[-Name] <string[]>] [-Force] [-確認] [-WhatIf] [<CommonParameters>]

C:\PS>Disable-PSSessionConfiguration

説明
-----------
このコマンドは、Microsoft.PowerShell セッション構成を無効にします。

C:\PS>disable-pssessionConfiguration -name *

説明
-----------
このコマンドは、コンピューターに保存されている登録済みセッション構成をすべて無効にします。

C:\PS>disable-pssessionConfiguration -name Microsoft* -force

説明
-----------
このコマンドは、名前が "Microsoft" で始まるセッション構成をすべて無効にします。また、Force パラメーターを使用して、このコマンドからのユーザー プロンプトをすべて非表示にします。

C:\PS>Get-PSSessionConfiguration -name MaintenanceShell, AdminShell | Disable-PSSessionConfiguration

説明
-----------
このコマンドは、MaintenanceShell と AdminShell の各セッション構成を無効にします。

また、パイプライン演算子 (|) を使用して、Get-PSSessionConfiguration コマンドの結果を Disable-PSSessionConfiguration に送ります。

C:\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

C:\PS> Disable-PSSessionConfiguration -name MaintenanceShell -force

C:\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

C:\PS> Set-PSSessionConfiguration -name MaintenanceShell -MaximumReceivedDataSizePerCommandMB 60

ParamName            ParamValue
---------            ----------
psmaximumreceived... 60

"Restart WinRM service"
WinRM service need to be restarted to make the changes effective. Do you want to run the command "restart-service winrm"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"): y


C:\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_Troubl
eshooting Help topic.
    + CategoryInfo          : OpenError: (System.Manageme....RemoteRunspace:RemoteRunspace) [], PSRemotingTransportException
    + FullyQualifiedErrorId : PSSessionOpenFailed

説明
-----------
この例は、セッション構成を無効にしたときの結果を示しています。

最初のコマンドは、Get-SessionConfiguration コマンドレットと Format-Table コマンドレットを使用して、セッション構成オブジェクトの Name プロパティと Permission プロパティだけを表示します。この表形式によって、オブジェクトの値を確認しやすくなります。コマンドの結果には、Administrators グループのメンバーがセッション構成の使用を許可されていることが示されます。

2 番目のコマンドは、Disable-PSSessionConfiguration コマンドレットを使用して、MaintenanceShell セッション構成を無効にします。また、Force パラメーターを使用して、ユーザー プロンプトをすべて非表示にします。

3 番目のコマンドは最初のコマンドを繰り返します。コマンドの結果には、MaintenanceShell セッション構成へのアクセスが全ユーザーに対して拒否されているにもかかわらず、このセッション構成を表すオブジェクトを引き続き取得できることが示されます。"AccessDenied" エントリは、セキュリティ記述子の他のどのエントリよりも優先されます。

4 番目のコマンドは、Set-PSSessionConfiguration コマンドレットを使用して、MaintenanceShell セッション構成の MaximumDataSizePerCommandMB 設定を 60 に増加します。コマンドの結果には、セッション構成へのアクセスが全ユーザーに対して拒否されているにもかかわらず、コマンドが正常に実行されたことが示されます。

5 番目のコマンドは、セッションにおける MaintenanceShell セッション構成の使用を試行します。このコマンドは、New-PSSession コマンドレットを使用して新しいセッションを作成し、ConfigurationName パラメーターを使用して MaintenanceShell 構成を指定します。実行結果には、ユーザーがセッション構成に対するアクセスを拒否されたため、New-PSSession コマンドの実行が失敗したことが示されます。