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

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

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

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

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

Примеры

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

Эта команда меняет имя типа развертывания с complex install на Advanced install. Он добавляет английский (США) () и 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

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

• New-CMDetectionClauseDirectory
• New-CMDetectionClauseFile
• New-CMDetectionClauseRegistryKey
• New-CMDetectionClauseRegistryKeyValue
• New-CMDetectionClauseWindowsInstaller

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

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

Type:	DetectionClause[]
Aliases:	AddDetectionClauses
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddLanguage

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

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

Type:	String[]
Aliases:	AddLanguages, Languages, Language
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddRequirement

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

• New-CMRequirementRuleActiveDirectorySiteValue
• New-CMRequirementRuleBooleanValue
• New-CMRequirementRuleCMSiteValue
• New-CMRequirementRuleCommonValue
• New-CMRequirementRuleDeviceOwnershipValue
• New-CMRequirementRuleExistential
• New-CMRequirementRuleExpression
• New-CMRequirementRuleFileAttributeValue
• New-CMRequirementRuleFilePermissionValue
• New-CMRequirementRuleFreeDiskSpaceValue
• New-CMRequirementRuleInputTypeValue
• New-CMRequirementRuleOperatingSystemLanguageValue
• New-CMRequirementRuleOperatingSystemValue
• New-CMRequirementRuleOUValue
• New-CMRequirementRuleRegistryKeyPermissionValue
• New-CMRequirementRuleScreenResolutionValue

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

Type:	Rule[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Application

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

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

-ApplicationId

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

Type:	Int32
Aliases:	CI_ID, CIId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationName

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

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

-Comment

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

Type:	String
Aliases:	AdministratorComment
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

-DeploymentTypeName

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

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

-DetectionClauseConnector

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

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

Type:	Hashtable[]
Aliases:	DetectionClauseConnectors
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

-EstimatedRuntimeMins

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

Type:	Int32
Aliases:	EstimatedInstallationTimeMinutes, EstimatedInstallationTimeMins, EstimatedRunTimeMinutes
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceScriptDetection32Bit

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

Type:	Boolean
Aliases:	Force32BitDetectionScript
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

-GroupDetectionClauses

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

• New-CMDetectionClauseDirectory
• New-CMDetectionClauseFile
• New-CMDetectionClauseRegistryKey
• New-CMDetectionClauseRegistryKeyValue
• New-CMDetectionClauseWindowsInstaller

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

Совет

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

Type:	String[]
Aliases:	GroupDetectionClausesByLogicalName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

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

Type:	IResultObject
Aliases:	DeploymentType
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-InstallationBehaviorType

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

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

Type:	InstallationBehaviorType
Accepted values:	InstallForUser, InstallForSystem, InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InstallTaskSequenceId

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

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

-LogonRequirementType

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

• OnlyWhenNoUserLoggedOn: Только в том случае, если пользователь не Windows.

• OnlyWhenUserLoggedOn: Только при вписыве пользователя. Этот параметр является по умолчанию.

• WhetherOrNotUserLoggedOn. Независимо от того, вписается ли пользователь.

  Примечание

  Значение WhereOrNotUserLoggedOn неоценяемо. Он заменен WhetherOrNotUserLoggedOn .

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

Type:	LogonRequirementType
Accepted values:	OnlyWhenUserLoggedOn, WhereOrNotUserLoggedOn, WhetherOrNotUserLoggedOn, OnlyWhenNoUserLoggedOn
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MaximumRuntimeMins

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

Type:	Int32
Aliases:	MaximumAllowedRunTimeMinutes, MaximumAllowedRunTimeMins, MaximumRunTimeMinutes
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NewName

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

Type:	String
Aliases:	NewDeploymentTypeName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

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

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

-ProductCode

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

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

-RebootBehavior

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

• BasedOnExitCode: Определение поведения на основе кодов возврата.

• NoAction: Никаких конкретных действий.

• ProgramReboot: Программа установки программного обеспечения может привести к перезапуску устройства.

• ForceReboot. Клиент Configuration Manager принудит к обязательной перезагрузке устройства.

Дополнительные сведения об этих действиях см. в приложении Create in Configuration Manager.

Type:	PostExecutionBehavior
Accepted values:	BasedOnExitCode, NoAction, ForceReboot, ProgramReboot
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveDetectionClause

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

Type:	String[]
Aliases:	RemoveDetectionClauses
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveLanguage

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

Type:	String[]
Aliases:	RemoveLanguages
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveRequirement

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

Type:	Rule[]
Aliases:	RemoveRequirements
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RequireUserInteraction

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

Type:	Boolean
Aliases:	RequiresUserInteraction
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ScriptFile

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

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

-ScriptLanguage

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

Type:	ScriptLanguage
Aliases:	ScriptType
Accepted values:	PowerShell, VBScript, JavaScript
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ScriptText

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

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

Type:	String
Aliases:	ScriptContent, Script
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SlowNetworkDeploymentMode

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

• DoNothing: Не скачив контент
• Download: Скачайте контент из точки распространения и запустите локально

Type:	ContentHandlingMode
Accepted values:	DoNothing, Download
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UninstallTaskSequenceId

ID последовательности задач, чтобы удалить приложение.

Type:	String
Aliases:	ContentLocation, UninstallId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UserInteractionMode

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

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

Type:	UserInteractionMode
Aliases:	InstallationProgramVisibility
Accepted values:	Normal, Minimized, Maximized, Hidden
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

-Принудительно

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

Type:	SwitchParameter
Aliases:	ForceForUnknownPublisher
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

System.Object

Связанные ссылки

• Add-CMTaskSequenceDeploymentType
• Get-CMDeploymentType
• Remove-CMDeploymentType
• Get-CMApplication
• Тип развертывания последовательности задач