Stop-DscConfiguration
Останавливает выполняемое задание конфигурации.
Синтаксис
All
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. Параметр учетных данных $Session. При выполнении команды появится запрос на пароль учетной записи пользователя.
Параметры
-AsJob
Указывает, что этот командлет выполняет команду в качестве фонового задания. Дополнительные сведения о фоновых заданиях PowerShell см. в about_Jobs и about_Remote_Jobs.
Чтобы использовать параметр AsJob, локальные и удаленные компьютеры должны быть настроены для удаленного взаимодействия. В Windows Vista и более поздних версиях операционной системы Windows необходимо открыть PowerShell с помощью параметра запуска от имени администратора. Дополнительные сведения см. в about_Remote_Requirements.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-CimSession
Выполняет командлет в удаленном сеансе или на удаленном компьютере. Введите имя компьютера или объект сеанса, например выходные данные из New-CimSession или Get-CimSession.
Свойства параметра
| Тип: | |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | Сессия |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Confirm
Stop-DscConfiguration не поддерживает параметр Confirm. Если используется параметр Подтверждения, отображается ошибка.
Для командлетов PowerShell, поддерживающих подтвердить, используя запрос на проверку перед выполнением команды.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | cf |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Force
Принудительно выполняется команда без запроса подтверждения пользователя.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ThrottleLimit
Указывает максимальное количество параллельных операций, которые можно установить для выполнения командлета.
Если этот параметр опущен или введено значение 0, PowerShell вычисляет оптимальное ограничение регулирования на основе количества командлетов CIM, выполняемых на компьютере. Ограничение регулирования применяется только к текущему командлету, а не к сеансу или к компьютеру.
Свойства параметра
| Тип: | Int32 |
| 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.
