Add-CMTaskSequenceDeploymentType

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

Синтаксис

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

Описание

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

Синтаксис этого командлета аналогичен командлету типа развертывания MSI Add-CMMsiDeploymentType. Основными отличиями являются следующие параметры:

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

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

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

Примеры

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

В этом примере в CBI приложения добавляется идентификатор последовательности задач ABC001EB. Он также добавляет идентификатор последовательности задач удаления ABC00378.

Add-CMTaskSequenceDeploymentType -ApplicationName "CBI" -DeploymentTypeName "Complex install" -Comment "New Deployment Type" -InstallTaskSequenceId "ABC001EB" -UninstallTaskSequenceId "ABC00378" -ScriptLanguage "PowerShell" -ScriptText "dir"

Параметры

-AddDetectionClause

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

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

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

Тип:DetectionClause[]
Aliases:AddDetectionClauses
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера: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

-ApplicationId

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

Тип:Int32
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-разрядных клиентах.

Тип:SwitchParameter
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-CMApplication .

Тип:IResultObject
Aliases:Application
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

-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

-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 чтобы разрешить пользователям просматривать установку типа развертывания и взаимодействовать с ней.

Тип:SwitchParameter
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
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ScriptText

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

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

Тип:String
Aliases:ScriptContent
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:UninstallId, UninstallTaskSequencePackageId
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