New-CMTSStepRunCommandLine
Создайте шаг Run Command Line, который можно добавить в последовательность задач.
Синтаксис
New-CMTSStepRunCommandLine
-CommandLine <String>
[-DisableWow64Redirection]
[-PackageId <String>]
[-RunAsUser]
[-SuccessCode <Int32[]>]
[-Timeout <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMTSStepRunCommandLine
-CommandLine <String>
[-DisableWow64Redirection]
[-OutputVariableName <String>]
[-PackageId <String>]
[-RunAsUser]
[-SuccessCode <Int32[]>]
[-Timeout <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMTSStepRunCommandLine
-CommandLine <String>
[-DisableWow64Redirection]
[-OutputVariableName <String>]
[-PackageId <String>]
[-RunAsUser]
[-SuccessCode <Int32[]>]
[-Timeout <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-Condition <IResultObject[]>]
[-ContinueOnError]
[-Description <String>]
[-Disable]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
В этом командлете создается новый объект шаговой строки Run Command Line. Затем используйте кодлет Add-CMTaskSequenceStep, чтобы добавить шаг в последовательность задач. Дополнительные сведения об этом шаге см. в дополнительных сведениях о действиях последовательности задач: Run Command Line.
Примечание
Запустите команды диспетчера конфигурации из диска веб-сайта Configuration Manager, например PS XYZ:\>
. Дополнительные сведения см. в дополнительных сведениях о том, как начать работу.
Примеры
Пример1
В этом примере сначала создается объект для шага Run Command Line. В нем указана строка команды и пакет, который необходимо использовать.
Затем он получает объект последовательности задач и добавляет этот новый шаг в последовательность задач в индексе 11.
$step = New-CMTSStepRunCommandLine -Name "Run Command Line" -CommandLine "cmd.exe /c copy Jan98.dat c:\sales\Jan98.dat" -PackageId "XYZ00821"
$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast
$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11
Параметры
-CommandLine
Укажите строку команд, которую выполняет последовательность задач. Включай, например, расширения имен .exe
файлов. Включай все необходимые файлы параметров и параметры командной строки.
Пример: cmd.exe /c copy Jan98.dat c:\sales\Jan98.dat
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Condition
Укажите объект условия, который можно использовать с помощью этого шага. Чтобы получить этот объект, используйте один из комлетов условий последовательности задач. Например, Get-CMTSStepConditionVariable.
Type: | IResultObject[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Перед запуском командлет запросит подтверждение.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueOnError
Добавьте этот параметр, чтобы включить параметр Шаг Продолжить ошибку. Когда вы включаете этот параметр, если шаг не удается, последовательность задач продолжается.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Укажите необязательное описание для этого шага последовательности задач.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Этот параметр рассматривает символы под диктовки как буквальные значения символов. Вы не можете объединить его с ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWow64Redirection
По умолчанию 64-битные операционные системы используют перенаправление файловой системы WOW64 для запуска командных строк. Это поведение— правильное поиск 32-битных версий исполняемых и библиотек ОС. Добавьте этот параметр, чтобы отключить использование перенаправления файловой системы WOW64. Windows выполняет команду с помощью 64-битных версий исполняемых и библиотек ОС. Этот параметр не влияет при работе на 32-битной ОС.
Type: | SwitchParameter |
Aliases: | DisableRedirectionFor64BitFileSystem |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Этот параметр обрабатывает символы под диктовки и может привести к неожиданному поведению (не рекомендуется). Вы не можете объединить его с DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Укажите имя для этого шага, чтобы идентифицировать его в последовательности задач.
Type: | String |
Aliases: | StepName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OutputVariableName
Укажите имя переменной последовательности настраиваемой задачи. При использовании этого параметра этот шаг сохраняет последние 1000 символов вывода команды к переменной.
Type: | String |
Aliases: | Output, OutputVariable |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PackageId
При указании файлов или программ в командной строке, которые еще не существуют на компьютере назначения, используйте этот параметр для указания ID пакета для пакета с необходимыми файлами. Пакет не требует программы. Если указанные файлы существуют на компьютере назначения, этот параметр не требуется.
Это значение является стандартным ID пакета, например XYZ00821
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsUser
Добавьте этот параметр для запуска командной строки в качестве Windows учетной записи пользователя, а не локальной учетной записи системы. Затем используйте параметры UserName и UserPassword.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SuccessCode
Укажите массив значений в качестве кодов выхода из команды, которую шаг должен оценить как успешность.
Type: | Int32[] |
Aliases: | SuccessCodes |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Timeout
Укажите значение integer, которое представляет, как долго диспетчер конфигурации позволяет запускать командную строку. Это значение может быть от 1
минуты до 999
минуты. Значение по умолчанию — 15
минуты.
Если вы вводите значение, которое не позволяет выполнить указанную команду достаточно времени, этот шаг завершается сбой. Вся последовательность задач может привести к сбой в зависимости от условий шага или группы. Если срок расторжения истекает, диспетчер конфигурации завершает процесс командной строки.
Type: | Int32 |
Aliases: | TimeoutInMinutes |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserName
При использовании параметра RunAsUser используйте этот параметр, чтобы указать имя учетной записи Windows пользователя. Чтобы указать пароль учетной записи, используйте параметр UserPassword.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserPassword
При использовании параметра RunAsUser используйте этот параметр, чтобы указать пароль учетной записи, указыванный с помощью userName.
Type: | SecureString |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Этот комдлет не работает.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WorkingDirectory
Укажите папку, в которой запускается команда. Этот путь может быть до 127 символов.
Type: | String |
Aliases: | StartIn |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Отключение
Добавьте этот параметр, чтобы отключить этот шаг последовательности задач.
Type: | SwitchParameter |
Aliases: | DisableThisStep |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
Нет
Выходные данные
IResultObject
Примечания
Дополнительные сведения об этом возвращаемом объекте и его свойствах см. в SMS_TaskSequence_RunCommandLineAction класса WMI сервера.