Поделиться через

Disable-PSSessionConfiguration

Модуль:
Microsoft.PowerShell.Core Module

Отключает конфигурации сеанса на локальном компьютере.

Синтаксис

Default (по умолчанию) 

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

Описание

Этот командлет доступен только на платформе Windows.

Командлет Disable-PSSessionConfiguration отключает конфигурации сеансов на локальном компьютере, что запрещает всем пользователям использовать конфигурации сеансов для создания управляемых пользователем сеансов (PSSessions) на локальном компьютере. Это расширенный командлет, предназначенный для использования системными администраторами для управления настраиваемыми конфигурациями сеансов для своих пользователей.

Начиная с PowerShell 3.0 командлет задает для параметра включенной параметра конфигурации сеанса () значение False.

В PowerShell 2.0 командлет Disable-PSSessionConfiguration добавляет запись 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-PSSessionConfigurationDisable-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

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Force

Принудительно выполняется команда без запроса подтверждения пользователя.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Name

Задает массив имен конфигураций сеансов для отключения. Введите одно или несколько имен конфигурации. Разрешено использование подстановочных символов. Можно также передать строку, содержащую имя конфигурации или объект конфигурации сеанса, в Disable-PSSessionConfiguration.

Если этот параметр не указан, Disable-PSSessionConfiguration отключает конфигурацию сеанса Microsoft.PowerShell .

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:True
DontShow:False

Наборы параметров

(All)
Position:0
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-NoServiceRestart

Используется для предотвращения перезапуска службы WSMan. Не обязательно перезапустить службу, чтобы отключить конфигурацию.

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

Показывает, что произойдет, если командлет будет запущен. Командлет не запускается.

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position: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

Этот командлет не возвращает выходные данные.

Примечания

Этот командлет доступен только на платформах Windows.

Чтобы запустить этот командлет, необходимо запустить PowerShell с помощью параметра запуска от имени администратора.