Disable-PSSessionConfiguration

项目
10/30/2009

拒绝访问本地计算机上的会话配置。

语法

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

说明

Disable-PSSessionConfiguration cmdlet 阻止所有计算机用户在会话中使用会话配置。这是一个高级 cmdlet，供系统管理员为其用户管理自定义会话配置时使用。

Disable-PSSessionConfiguration cmdlet 向一个或多个已注册会话配置的安全描述符添加“全部拒绝”设置。因此，您可以注销、查看和更改这些配置，但不能在会话中使用它们。

如果不使用参数，Disable-PSSessionConfiguration 将禁用 Microsoft.PowerShell 配置，即用于会话的默认配置。除非用户指定了其他配置，否则这将有效地阻止本地和远程用户创建连接到计算机的任何会话。

若要禁用计算机上的所有会话配置，请使用 Disable-PSRemoting。

参数

-Force

禁止显示所有用户提示。默认情况下，提示您确认每个操作。

是否为必需？	false
位置？	named
默认值	False
是否接受管道输入？	false
是否接受通配符？	false

-Name <string[]>

指定要禁用的会话配置的名称。输入一个或多个配置名称。允许使用通配符。也可以通过管道将包含配置名称的字符串或将会话配置对象传递给 Disable-PSSessionConfiguration。

如果省略此参数，Disable-PSSessionConfiguration 将禁用 Microsoft.PowerShell 会话配置。

是否为必需？	false
位置？	1
默认值	Microsoft.PowerShell
是否接受管道输入？	true (ByValue, ByPropertyName)
是否接受通配符？	true

-Confirm

在执行命令之前提示您进行确认。

是否为必需？	false
位置？	named
默认值
是否接受管道输入？	false
是否接受通配符？	false

-WhatIf

描述如果执行该命令会发生什么情况（无需实际执行该命令）。

是否为必需？	false
位置？	named
默认值
是否接受管道输入？	false
是否接受通配符？	false

<CommonParameters>

此 cmdlet 支持通用参数：-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息，请参阅 about_Commonparameters.

输入和输出

输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。

输入

Microsoft.PowerShell.Commands.PSSessionConfigurationCommands#PSSessionConfiguration, System.String

可以通过管道将会话配置对象或包含会话配置名称的字符串传递给 Disable-PSSessionConfiguration。

输出

无

此 cmdlet 不返回任何对象。

说明

若要在 Windows Vista、Windows Server 2008 以及更高版本的 Windows 上运行此 cmdlet，您必须使用“以管理员身份运行”选项启动 Windows PowerShell。

示例 1

C:\PS>Disable-PSSessionConfiguration

说明
-----------
此命令禁用 Microsoft.PowerShell 会话配置。

示例 2

C:\PS>disable-pssessionConfiguration -name *

说明
-----------
此命令禁用计算机上的所有已注册会话配置。

示例 3

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

说明
-----------
此命令禁用名称以“Microsoft”开头的所有会话配置。该命令使用 Force 参数禁止显示所有用户提示。

示例 4

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

说明
-----------
此命令禁用 MaintenanceShell 和 AdminShell 会话配置。

该命令使用管道运算符 (|) 将 Get-PSSessionConfiguration 命令的结果发送到 Disable-PSSessionConfiguration。

示例 5

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 cmdlet 只显示会话配置对象的 Name 和 Permission 属性。使用这种表格式便于查看对象值。结果显示允许 Administrators 组的成员使用会话配置。

第二条命令使用 Disable-PSSessionConfiguration cmdlet 禁用 MaintenanceShell 会话配置。该命令使用 Force 参数禁止显示所有用户提示。

第三条命令重复第一条命令。结果显示您仍可以获取表示 MaintenanceShell 会话配置的对象，即使拒绝所有用户访问该对象也是如此。“AccessDenied”条目优先于安全描述符中的所有其他条目。

第四条命令使用 Set-PSSessionConfiguration cmdlet 将 MaintenanceShell 会话配置上的 MaximumDataSizePerCommandMB 设置增大为 60。结果显示该命令成功执行，即使拒绝所有用户访问该配置也是如此。

第五条命令尝试在会话中使用 MaintenanceShell 会话配置。它使用 New-PSSession cmdlet 创建新会话，并使用 ConfigurationName 参数指定 MaintenanceShell 配置。由于拒绝该用户访问该配置，因此结果显示 New-PSSession 命令失败。

另请参阅

概念

about_Session_Configurations
Enable-PSSessionConfiguration
Get-PSSessionConfiguration
Register-PSSessionConfiguration
Set-PSSessionConfiguration
Unregister-PSSessionConfiguration
WSMan Provider

通过