Stop-DscConfiguration
Останавливает выполняемое задание конфигурации.
Синтаксис
Stop-DscConfiguration
[-Force]
[-CimSession <CimSession[]>]
[-ThrottleLimit <Int32>]
[-AsJob]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Описание
Командлет Stop-DscConfiguration останавливает выполняемое задание конфигурации. Укажите компьютеры, к которым применяется этот командлет с помощью сеансов Common Information Model (CIM). Если задание конфигурации не выполняется, этот командлет возвращает предупреждение.
Stop-DscConfiguration доступен только в рамках накопительного пакета обновления ноября 2014 г. для Windows RT 8.1, Windows 8.1 и Windows Server 2012 R2 из библиотеки поддержки Майкрософт. Перед использованием этого командлета просмотрите сведения в новые возможности Windows PowerShell 5.0
Примеры
Пример 1. Остановка задания конфигурации
В этом примере сеанс CIM создается с помощью командлета New-CimSession. Объект CimSession используется для остановки выполняемого задания конфигурации.
$Session = New-CimSession -ComputerName Server01 -Credential ACCOUNTS\User01
Stop-DscConfiguration -CimSession $Session
New-CimSession использует параметр ComputerName для указания компьютера Server01. Параметр учетных данных указывает учетную запись пользователя. Объект CimSession хранится в переменной $Session. При выполнении команды появится запрос на пароль учетной записи пользователя.
Stop-DscConfiguration использует параметр CimSession и объект, хранящийся в $Session, чтобы остановить задание конфигурации.
Параметры
-AsJob
Указывает, что этот командлет выполняет команду в качестве фонового задания. Дополнительные сведения о фоновых заданиях PowerShell см. в about_Jobs и about_Remote_Jobs.
Чтобы использовать параметр AsJob, локальные и удаленные компьютеры должны быть настроены для удаленного взаимодействия. В Windows Vista и более поздних версиях операционной системы Windows необходимо открыть PowerShell с помощью параметра запуска от имени администратора. Дополнительные сведения см. в about_Remote_Requirements.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-CimSession
Выполняет командлет в удаленном сеансе или на удаленном компьютере. Введите имя компьютера или объект сеанса, например выходные данные из New-CimSession или Get-CimSession.
| Тип: | CimSession[] |
| Aliases: | Session |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Confirm
Stop-DscConfiguration не поддерживает параметр Confirm. Если используется параметр Подтверждения, отображается ошибка.
Для командлетов PowerShell, поддерживающих подтвердить, используя запрос на проверку перед выполнением команды.
| Тип: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Force
Принудительно выполняется команда без запроса подтверждения пользователя.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-ThrottleLimit
Указывает максимальное количество параллельных операций, которые можно установить для выполнения командлета.
Если этот параметр опущен или введено значение 0, PowerShell вычисляет оптимальное ограничение регулирования на основе количества командлетов CIM, выполняемых на компьютере. Ограничение регулирования применяется только к текущему командлету, а не к сеансу или к компьютеру.
| Тип: | Int32 |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.
| Тип: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
Входные данные
None
Выходные данные
None
