Set-CMTaskSequenceDeploymentType

Ссылка

Модуль:: ConfigurationManager

Настройка типа развертывания последовательности задач в приложении.

Синтаксис

Set-CMTaskSequenceDeploymentType
   [-AddDetectionClause <DetectionClause[]>]
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit <Boolean>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RemoveDetectionClause <String[]>]
   [-RequireUserInteraction <Boolean>]
   [-ScriptFile <String>]
   [-ScriptLanguage <ScriptLanguage>]
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   -ApplicationName <String>
   -DeploymentTypeName <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequenceDeploymentType
   [-AddDetectionClause <DetectionClause[]>]
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit <Boolean>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RemoveDetectionClause <String[]>]
   [-RequireUserInteraction <Boolean>]
   [-ScriptFile <String>]
   [-ScriptLanguage <ScriptLanguage>]
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   -Application <IResultObject>
   -DeploymentTypeName <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequenceDeploymentType
   [-AddDetectionClause <DetectionClause[]>]
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit <Boolean>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RemoveDetectionClause <String[]>]
   [-RequireUserInteraction <Boolean>]
   [-ScriptFile <String>]
   [-ScriptLanguage <ScriptLanguage>]
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   -ApplicationId <Int32>
   -DeploymentTypeName <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequenceDeploymentType
   [-AddDetectionClause <DetectionClause[]>]
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit <Boolean>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RemoveDetectionClause <String[]>]
   [-RequireUserInteraction <Boolean>]
   [-ScriptFile <String>]
   [-ScriptLanguage <ScriptLanguage>]
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Применяется к версии 2006 и более поздним. Используйте этот командлет для настройки типа развертывания последовательности задач в приложении. Дополнительные сведения см. в разделе Тип развертывания последовательности задач.

Этот командлет имеет тот же синтаксис, что и командлет типа развертывания MSI Set-CMMsiDeploymentType. Основными отличиями являются следующие параметры:

-InstallTaskSequenceId <string> (обязательный): идентификатор последовательности задач для установки приложения.
-UninstallTaskSequenceId <string> (необязательно): идентификатор последовательности задач для удаления приложения.

Эти два параметра связаны с параметрами последовательности задач типа развертывания. Они заменяют -InstallCommand параметры и -UninstallCommand в командлете MSI.

Примеры

Пример 1. Изменение типа развертывания последовательности задач

Эта команда изменяет имя типа развертывания со Сложной установки на Расширенная установка. Он добавляет английский (США) () иen-USкитайский (упрощенное письмо) () вzh-CN качестве поддерживаемых языков. Он указывает, что установка займет около 14 минут и будет выполняться только в том случае, если пользователи не вошли в Windows.

Set-CMMSiDeploymentType -ApplicationName "CBI" -DeploymentTypeName "Complex install" -NewName "Advanced install" -AddLanguage "en-US","zh-CN" -Comment "New Deployment Type-updated" -EstimatedRuntimeMins 14 -LogonRequirementType OnlyWhenNoUserLoggedOn

Другие примеры с правилами требований и методами обнаружения см. в разделах Set-CMScriptDeploymentType и Add-CMMsiDeploymentType.

Параметры

-AddDetectionClause

Укажите массив предложений методов обнаружения для этого типа развертывания. Чтобы создать предложение обнаружения, используйте один из следующих командлетов:

Сохраните выходные данные этих командлетов в переменную. Затем укажите эти переменные в качестве массива для этого параметра. Например, -AddDetectionClause $clauseFile1,$clauseFile2,$clauseFile3.

Вы также можете использовать Get-CMDeploymentTypeDetectionClause , чтобы получить существующее предложение обнаружения из другого приложения.

Тип:	DetectionClause[]
Aliases:	AddDetectionClauses
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-AddLanguage

Укажите массив тегов языка, поддерживаемых типом развертывания. Например, чтобы добавить русский (Россия), укажите тег ru-RU.

Дополнительные сведения и список тегов языка см. в справочнике по идентификатору кода языка Windows (LCID).

Тип:	String[]
Aliases:	AddLanguages, Languages, Language
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-AddRequirement

Укажите массив объектов-требований для типа развертывания. Чтобы создать объект правила требования, используйте один из следующих командлетов:

Начиная с версии 2111, можно использовать командлет Get-CMDeploymentTypeRequirement для копирования правил из другого типа развертывания.

Тип:	Rule[]
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Application

Укажите объект приложения для этого типа развертывания. Чтобы получить этот объект, используйте командлет Get-CMApplication .

Тип:	IResultObject
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ApplicationId

Укажите идентификатор приложения для этого типа развертывания.

Тип:	Int32
Aliases:	CI_ID, CIId
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ApplicationName

Укажите имя приложения для этого типа развертывания.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Comment

Укажите необязательное описание для типа развертывания.

Тип:	String
Aliases:	AdministratorComment
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Confirm

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

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DeploymentTypeName

Укажите имя настраиваемого типа развертывания.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DetectionClauseConnector

При использовании параметра GroupDetectionClauses для группирования предложений обнаружения используйте этот параметр, чтобы указать соединитель.

В следующем примере определяется соединитель OR : @{"LogicalName"=$clauseFile3.Setting.LogicalName;"Connector"="OR"}

Тип:	Hashtable[]
Aliases:	DetectionClauseConnectors
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-EstimatedRuntimeMins

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

Тип:	Int32
Aliases:	EstimatedInstallationTimeMinutes, EstimatedInstallationTimeMins, EstimatedRunTimeMinutes
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Force

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

Тип:	SwitchParameter
Aliases:	ForceForUnknownPublisher
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ForceScriptDetection32Bit

Если вы используете пользовательский скрипт для обнаружения присутствия этого типа развертывания, задайте для этого параметра $true значение, чтобы запустить скрипт в качестве 32-разрядного процесса на 64-разрядных клиентах.

Тип:	Boolean
Aliases:	Force32BitDetectionScript
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-GroupDetectionClauses

При настройке правил для обнаружения присутствия этого типа развертывания используйте этот параметр для группирования предложений. Чтобы создать предложение обнаружения, используйте один из следующих командлетов:

Сохраните выходные данные этих командлетов в переменную. Затем используйте следующий формат для группировки предложений: $clause2.Setting.LogicalName, $clause3.Setting.LogicalName.

Совет

В консоли Configuration Manager при выборе действия Группировать предложения отображают круглые скобки до и после сгруппированных предложений.

Тип:	String[]
Aliases:	GroupDetectionClausesByLogicalName
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-InputObject

Укажите объект типа развертывания для настройки. Чтобы получить этот объект, используйте командлет Get-CMDeploymentType .

Тип:	IResultObject
Aliases:	DeploymentType
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-InstallationBehaviorType

Укажите поведение установки для этого типа развертывания:

InstallForUser: клиент устанавливает приложение только для пользователя, для которого вы развертываете приложение.
InstallForSystem: клиент устанавливает приложение только один раз. Он доступен для всех пользователей.
InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser: при развертывании приложения на устройстве клиент устанавливает его для всех пользователей. При развертывании приложения для пользователя клиент устанавливает его только для этого пользователя.

Тип:	InstallationBehaviorType
Допустимые значения:	InstallForUser, InstallForSystem, InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-InstallTaskSequenceId

Идентификатор последовательности задач для установки приложения.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-LogonRequirementType

Укажите требование для пользователя, выполнившего вход:

OnlyWhenNoUserLoggedOn: только в том случае, если пользователь не вошел в Windows.
OnlyWhenUserLoggedOn: только при входе пользователя. Этот параметр используется по умолчанию.
WhetherOrNotUserLoggedOn: выполняется ли вход пользователя.

Примечание.

Значение WhereOrNotUserLoggedOn не рекомендуется. Он заменен WhetherOrNotUserLoggedOnна .

Если для параметра InstallationBehaviorType задано значение InstallForUser, этот параметр задать нельзя.

Тип:	LogonRequirementType
Допустимые значения:	OnlyWhenUserLoggedOn, WhereOrNotUserLoggedOn, WhetherOrNotUserLoggedOn, OnlyWhenNoUserLoggedOn
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-MaximumRuntimeMins

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

Тип:	Int32
Aliases:	MaximumAllowedRunTimeMinutes, MaximumAllowedRunTimeMins, MaximumRunTimeMinutes
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-NewName

Укажите новое имя для переименования этого типа развертывания.

Тип:	String
Aliases:	NewDeploymentTypeName
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PassThru

Добавьте этот параметр, чтобы вернуть объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не может создавать выходные данные.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ProductCode

Если в приложении используется технология установщика Windows, укажите код продукта MSI, который следует задать в качестве метода обнаружения. При использовании этого параметра он перезаписывает все существующие методы обнаружения.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RebootBehavior

Укажите поведение после установки:

BasedOnExitCode: определяет поведение на основе кодов возврата.
NoAction: нет конкретного действия.
ProgramReboot: программа установки программного обеспечения может принудительно перезапустить устройство.
ForceReboot: клиент Configuration Manager принудительно перезапустит устройство.

Дополнительные сведения об этом поведении см. в статье Создание приложений в Configuration Manager.

Тип:	PostExecutionBehavior
Допустимые значения:	BasedOnExitCode, NoAction, ForceReboot, ProgramReboot
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RemoveDetectionClause

Укажите массив предложений методов обнаружения для удаления.

Тип:	String[]
Aliases:	RemoveDetectionClauses
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RemoveLanguage

Укажите массив поддерживаемых языков для удаления из этого типа развертывания.

Тип:	String[]
Aliases:	RemoveLanguages
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RemoveRequirement

Укажите массив правил требований для удаления из этого типа развертывания.

Тип:	Rule[]
Aliases:	RemoveRequirements
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-RequireUserInteraction

Задайте для этого параметра значение , $true чтобы разрешить пользователям просматривать установку типа развертывания и взаимодействовать с ней.

Тип:	Boolean
Aliases:	RequiresUserInteraction
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ScriptFile

Укажите файл скрипта, используемый для обнаружения этого типа развертывания. Также используйте параметр ScriptLanguage .

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ScriptLanguage

Если вы используете параметры ScriptFile или ScriptText , используйте этот параметр, чтобы указать язык скрипта.

Тип:	ScriptLanguage
Aliases:	ScriptType
Допустимые значения:	PowerShell, VBScript, JavaScript
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ScriptText

Укажите текст скрипта для обнаружения этого типа развертывания. Также используйте параметр ScriptLanguage .

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

Тип:	String
Aliases:	ScriptContent, Script
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SlowNetworkDeploymentMode

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

DoNothing: не скачивайте содержимое
Download: скачайте содержимое из точки распространения и запустите локально.

Тип:	ContentHandlingMode
Допустимые значения:	DoNothing, Download
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-UninstallTaskSequenceId

Идентификатор последовательности задач для удаления приложения.

Тип:	String
Aliases:	ContentLocation, UninstallId
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-UserInteractionMode

Укажите видимость программы установки:

Normal: тип развертывания выполняется в обычном режиме на основе системных и программных значений по умолчанию. Этот режим используется по умолчанию.
Minimized: тип развертывания выполняется свернуто на клиентских устройствах. Действия установки могут отображаться пользователями в области уведомлений или на панели задач.
Maximized: тип развертывания выполняется максимально на клиентских устройствах. Пользователи видят все действия по установке.
Hidden: тип развертывания выполняется скрыто на клиентских устройствах. Пользователи не видят действий установки.

Тип:	UserInteractionMode
Aliases:	InstallationProgramVisibility
Допустимые значения:	Normal, Minimized, Maximized, Hidden
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-WhatIf

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

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

System.Object

Поделиться через