Stop-DscConfiguration

  • Ссылка
Модуль:
PSDesiredStateConfiguration

Останавливает выполняющееся задание конфигурации.

Синтаксис

Stop-DscConfiguration
    [-Force]
    [-CimSession <CimSession[]>]
    [-ThrottleLimit <Int32>]
    [-AsJob]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Описание

Командлет Stop-DscConfiguration останавливает выполняемое задание конфигурации. Укажите компьютеры, к которым применяется этот командлет, с помощью сеансов 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. Параметр Credential указывает учетную запись пользователя. Объект CimSession хранится в переменной $Session . При выполнении команды вам будет предложено ввести пароль учетной записи пользователя.

Stop-DscConfiguration использует параметр CimSession и объект, хранящийся в , $Session чтобы остановить задание конфигурации.

Параметры

-AsJob

Указывает, что этот командлет выполняет команду как фоновое задание. Дополнительные сведения о фоновых заданиях PowerShell см. в разделе about_Jobs и about_Remote_Jobs.

Чтобы использовать параметр AsJob , локальный и удаленный компьютеры должны быть настроены для удаленного взаимодействия. В Windows Vista и более поздних версиях операционной системы Windows необходимо открыть PowerShell с параметром Запуск от имени администратора . Дополнительные сведения см. в разделе about_Remote_Requirements.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CimSession

Запуск командлета в удаленном сеансе или на удаленном компьютере. Введите имя компьютера или объект сеанса, например выходные данные или New-CimSessionGet-CimSession.

Type:CimSession[]
Aliases:Session
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Stop-DscConfiguration не поддерживает параметр Confirm . Если используется параметр Confirm , отображается ошибка.

Для командлетов PowerShell, поддерживающих Confirm, использование параметра запрашивает проверку перед выполнением команды.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ThrottleLimit

Указание максимального количества одновременных операций, которые можно выполнять для запуска командлета.

Если этот параметр опущен или введено значение 0 , PowerShell вычисляет оптимальное ограничение регулирования на основе количества командлетов CIM, запущенных на компьютере. Предел регулирования применим только к текущему командлету, а не к сеансу или компьютеру.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Входные данные

None

Выходные данные

None