Создайте шаг Запуск скрипта PowerShell в последовательности задач.
\n","uid":"ConfigurationManager.New-CMTSStepRunPowerShellScript"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.New-CMTSStepRunPowerShellScript":{"href":"new-cmtssteprunpowershellscript","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMTSStepRunPowerShellScript","schemaType":"PowershellCmdlet","summary":"Создайте шаг Запуск скрипта PowerShell в последовательности задач.
\n","uid":"ConfigurationManager.New-CMTSStepRunPowerShellScript"}},"description":"Этот командлет создает новый объект шага Запуск скрипта PowerShell . Затем используйте командлет Add-CMTaskSequenceStep , чтобы добавить шаг в последовательность задач. Дополнительные сведения об этом шаге см. в разделе Сведения о шагах последовательности задач: запуск скрипта PowerShell.
\nПримечание.
\nЗапустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\\>. Дополнительные сведения см. в статье Начало работы.
В этом примере сначала создается объект для шага Запуск скрипта PowerShell . Он указывает пакет с именем выполняемого скрипта. Он задает политику выполнения PowerShell на наиболее безопасном уровне AllSigned , который требует, чтобы скрипт был подписан цифровой подписью.
\nЗатем он получает объект последовательности задач и добавляет этот новый шаг в последовательность задач по индексу 11.
\n","title":"Пример 1"}],"inputs":[{"description":"","name":"None\n"}],"links":[{"href":"get-cmtssteprunpowershellscript","text":"Get-CMTSStepRunPowerShellScript"},{"href":"remove-cmtssteprunpowershellscript","text":"Remove-CMTSStepRunPowerShellScript"},{"href":"set-cmtssteprunpowershellscript","text":"Set-CMTSStepRunPowerShellScript"},{"href":"/mem/configmgr/osd/understand/task-sequence-steps#BKMK_RunPowerShellScript","text":"Сведения о шагах последовательности задач: запуск сценария PowerShell"}],"module":"ConfigurationManager","name":"New-CMTSStepRunPowerShellScript","notes":"Дополнительные сведения об этом возвращаемом объекте и его свойствах см . в разделе SMS_TaskSequence_RunPowerShellScriptAction класс WMI сервера.
\n","outputs":[{"description":"","name":"IResultObject\n"}],"parameters":[{"aliases":"Conditions","defaultValue":"None","description":"Укажите объект условия для использования на этом шаге. Чтобы получить этот объект, используйте один из командлетов условия последовательности задач. Например, Get-CMTSStepConditionVariable.
\n","name":"Condition","parameterValueGroup":"","position":"Named","type":"IResultObject[]
\n"},{"aliases":"cf","defaultValue":"None","description":"Перед запуском командлет запросит подтверждение.
\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Добавьте этот параметр, чтобы включить параметр шага Продолжить при ошибке. Если этот параметр включен, если шаг завершается ошибкой, последовательность задач продолжается.
\n","name":"ContinueOnError","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Укажите необязательное описание для этого шага последовательности задач.
\n","name":"Description","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"DisableThisStep","defaultValue":"None","description":"Добавьте этот параметр, чтобы отключить этот шаг последовательности задач.
\n","name":"Disable","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"PowerShellExecutionPolicy","defaultValue":"None","description":"Укажите политику выполнения PowerShell для сценариев, которые можно запускать на компьютере. Выберите одну из следующих политик:
\n\n AllSigned: выполняются только скрипты, подписанные доверенным издателем.
\n Undefined: не определяйте политику выполнения.
\n Bypass: загрузите все файлы конфигурации и запустите все скрипты. Если вы скачаете неподписанный скрипт из Интернета, PowerShell не запрашивает разрешение перед выполнением скрипта.
Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"StepName","defaultValue":"None","description":"Укажите имя для этого шага, чтобы определить его в последовательности задач.
\n","isRequired":true,"name":"Name","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"Output, OutputVariable","defaultValue":"None","description":"Укажите имя настраиваемой переменной последовательности задач. При использовании этого параметра шаг сохраняет последние 1000 символов выходных данных команды в переменную.
\n","name":"OutputVariableName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Укажите идентификатор пакета , который содержит скрипт PowerShell. Для пакета не требуется программа. Один пакет может содержать несколько скриптов.
\nЭто значение является стандартным идентификатором пакета, например XYZ00821.
Затем используйте параметр ScriptName , чтобы указать имя скрипта.
\n","isRequired":true,"name":"PackageId","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"Parameters","defaultValue":"None","description":"Укажите параметры, передаваемые скрипту PowerShell. Эти параметры совпадают с параметрами скрипта PowerShell в командной строке. Укажите параметры, используемые скриптом, а не для командной строки PowerShell.
\nВ следующем примере содержатся допустимые параметры:
\n-MyParameter1 MyValue1 -MyParameter2 MyValue2
В следующем примере содержатся недопустимые параметры. Первые два элемента — это параметры командной строки PowerShell (NoLogo и ExecutionPolicy). Скрипт не использует эти параметры.
\n-NoLogo -ExecutionPolicy Unrestricted -File MyScript.ps1 -MyParameter1 MyValue1 -MyParameter2 MyValue2
Если значение параметра содержит специальный символ или пробел, используйте одинарные кавычки (') вокруг значения. Использование двойных кавычек (") может привести к неправильной обработке параметра на шаге последовательности задач.
Пример: -Arg1 '%TSVar1%' -Arg2 '%TSVar2%'
Для этого параметра также можно задать переменную последовательности задач. Например, если указать %MyScriptVariable%, когда последовательность задач выполняет скрипт, она добавляет значение этой настраиваемой переменной в командную строку PowerShell.
Укажите имя выполняемого скрипта. Этот скрипт находится в пакете, указанном параметром PackageId .
\n","isRequired":true,"name":"ScriptName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"SourceCode","defaultValue":"None","description":"Вместо использования параметров PackageId и ScriptName используйте этот параметр для непосредственного указания команд скрипта. Это строковое значение является командами PowerShell, которые выполняются на этом шаге.
\nСодержимое существующего файла скрипта можно считывать в строковую переменную, а затем использовать эту переменную для этого параметра. Например:
\n$script = [IO.File]::ReadAllText( "C:\\temp\\script.ps1" )
Укажите массив целочисленных значений в качестве кодов выхода из скрипта, который шаг должен вычислить как успешное.
\n","name":"SuccessCode","parameterValueGroup":"","position":"Named","type":"Int32[]
\n"},{"aliases":"TimeoutInMinutes","defaultValue":"None","description":"Укажите целочисленное значение, указывающее, как долго Configuration Manager позволяет выполнять скрипт. Это значение может быть от 1 минуты до 999 минут. Значение по умолчанию — минуты 15 .
Если ввести значение, которое не дает достаточно времени для успешного выполнения указанного скрипта, этот шаг завершается ошибкой. Вся последовательность задач может завершиться ошибкой в зависимости от условий шага или группы. Если истекло время ожидания, Configuration Manager завершает процесс PowerShell.
\n","name":"TimeoutMins","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"User","defaultValue":"None","description":"Этот параметр используется для запуска скрипта в качестве учетной записи пользователя Windows, а не от учетной записи локальной системы. Укажите имя учетной записи пользователя Windows. Чтобы указать пароль учетной записи, используйте параметр UserPassword .
\n","name":"UserName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"Password","defaultValue":"None","description":"Используйте этот параметр, чтобы указать пароль учетной записи, указанной с помощью userName.
\n","name":"UserPassword","parameterValueGroup":"","position":"Named","type":"SecureString\n"},{"aliases":"wi","defaultValue":"None","description":"Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.
\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"StartIn","defaultValue":"None","description":"Укажите папку, в которой запускается команда. Этот путь может содержать до 127 символов.
\n","name":"WorkingDirectory","parameterValueGroup":"","position":"Named","type":"String\n"}],"schema":"PowershellCmdlet","summary":"Создайте шаг Запуск скрипта PowerShell в последовательности задач.
\n","syntaxes":["New-CMTSStepRunPowerShellScript -NameСоздайте шаг Запуск скрипта PowerShell в последовательности задач.
\n","uid":"ConfigurationManager.New-CMTSStepRunPowerShellScript"}],"canonical_url":"https://learn.microsoft.com/ru-ru/powershell/module/configurationmanager/new-cmtssteprunpowershellscript?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/ru-ru/powershell/module/configurationmanager/new-cmtssteprunpowershellscript?view=sccm-ps"},"pageMetadata":"Этот командлет создает новый объект шага Запуск скрипта PowerShell . Затем используйте командлет Add-CMTaskSequenceStep , чтобы добавить шаг в последовательность задач. Дополнительные сведения об этом шаге см. в разделе Сведения о шагах последовательности задач: запуск скрипта PowerShell.\nПримечание.
\nЗапустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\\>. Дополнительные сведения см. в статье Начало работы.