Set-CMTaskSequenceDeploymentType
SYNOPSIS
Konfigurace typu nasazení pořadí úloh v aplikaci.
SYNTAX
ByAppName (výchozí)
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>]
ByAppValue
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>]
ByAppId
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>]
ByDTValue
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>]
DESCRIPTION
Platí pro verzi 2006 a novější. Pomocí této rutiny můžete nakonfigurovat typ nasazení pořadí úloh v aplikaci. Další informace najdete v tématu typ nasazení pořadí úloh.
Tato rutina má podobnou syntaxi jako typ nasazení MSI rutina set-CMMsiDeploymentType. Primární rozdíly jsou následující parametry:
-InstallTaskSequenceId <string>
(povinné): ID pořadí úkolů pro instalaci aplikace-UninstallTaskSequenceId <string>
(volitelné): ID pořadí úloh pro odinstalaci aplikace
Tyto dva parametry se vztahují k možnosti pořadí úkolů typ nasazení. Nahrazují -InstallCommand
-UninstallCommand
parametry a v rutině MSI.
EXAMPLES
Příklad 1: Změna typu nasazení pořadí úloh
Tento příkaz změní název typu nasazení ze složité instalace na pokročilou instalaci. Přidá angličtinu (USA) ( en-US
) a čínskou (zjednodušenou) ( zh-CN
) jako podporované jazyky. Určuje, že dokončení instalace bude trvat přibližně 14 minut a spustí se pouze v případě, že se k Windows žádní uživatelé nebudou přihlášeni.
Set-CMMSiDeploymentType -ApplicationName "CBI" -DeploymentTypeName "Complex install" -NewName "Advanced install" -AddLanguage "en-US","zh-CN" -Comment "New Deployment Type-updated" -EstimatedRuntimeMins 14 -LogonRequirementType OnlyWhenNoUserLoggedOn
Další příklady s pravidly požadavků a metodami zjišťování naleznete v tématu set-CMScriptDeploymentType a Add-CMMsiDeploymentType.
PARAMETERS
-AddDetectionClause
Zadejte pole klauzulí metody detekce pro tento typ nasazení. Chcete-li vytvořit klauzuli detekce, použijte jednu z následujících rutin:
- New-CMDetectionClauseDirectory
- New-CMDetectionClauseFile
- New-CMDetectionClauseRegistryKey
- New-CMDetectionClauseRegistryKeyValue
- New-CMDetectionClauseWindowsInstaller
Výstup těchto rutin uložte do proměnné. Pak zadejte tyto proměnné jako pole pro tento parametr. Například, -AddDetectionClause $clauseFile1,$clauseFile2,$clauseFile3
.
K získání existující klauzule detekce z jiné aplikace můžete použít také příkaz Get-CMDeploymentTypeDetectionClause .
Type: DetectionClause[]
Parameter Sets: (All)
Aliases: AddDetectionClauses
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AddLanguage
Zadejte pole značek jazyka, které podporuje typ nasazení. Chcete-li například přidat Rusko (Rusko), zadejte značku ru-RU
.
další informace a seznam značek jazyka naleznete v tématu Windows Reference identifikátoru kódu jazyka (LCID).
Type: String[]
Parameter Sets: (All)
Aliases: AddLanguages, Languages, Language
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AddRequirement
Zadejte pole objektů požadavků pro typ nasazení. Chcete-li vytvořit objekt pravidla požadavku, použijte jednu z následujících rutin:
- 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
Type: Rule[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
– Aplikace
Zadejte aplikační objekt pro tento typ nasazení. K získání tohoto objektu použijte rutinu Get-CMApplication .
Type: IResultObject
Parameter Sets: ByAppValue
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
– ApplicationId
Zadejte ID aplikace pro tento typ nasazení.
Type: Int32
Parameter Sets: ByAppId
Aliases: CI_ID, CIId
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
– ApplicationName
Zadejte název aplikace pro tento typ nasazení.
Type: String
Parameter Sets: ByAppName
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
– Komentář
Zadejte volitelný popis pro typ nasazení.
Type: String
Parameter Sets: (All)
Aliases: AdministratorComment
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeploymentTypeName
Zadejte název typu nasazení, který chcete konfigurovat.
Type: String
Parameter Sets: ByAppName, ByAppValue, ByAppId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DetectionClauseConnector
Když použijete parametr GroupDetectionClauses k seskupení klauzulí detekce, použijte tento parametr k zadání konektoru.
Následující příklad definuje konektor nebo : @{"LogicalName"=$clauseFile3.Setting.LogicalName;"Connector"="OR"}
Type: Hashtable[]
Parameter Sets: (All)
Aliases: DetectionClauseConnectors
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Tento parametr považuje zástupné znaky jako literálové hodnoty znaků. Nejde kombinovat s ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EstimatedRuntimeMins
Zadejte odhadovanou dobu instalace tohoto typu nasazení pro aplikaci v řádu minut. Centrum softwaru zobrazí tento odhad pro uživatele předtím, než se aplikace nainstaluje.
Type: Int32
Parameter Sets: (All)
Aliases: EstimatedInstallationTimeMinutes, EstimatedInstallationTimeMins, EstimatedRunTimeMinutes
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Force
Vynutí spuštění příkazu bez žádosti o potvrzení uživatele.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: ForceForUnknownPublisher
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceScriptDetection32Bit
Pokud použijete vlastní skript k detekci přítomnosti tohoto typu nasazení, nastavte tento parametr na, aby se $true
skript spouštěl jako 32 proces na 64 klientech.
Type: Boolean
Parameter Sets: (All)
Aliases: Force32BitDetectionScript
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučujeme). Nejde kombinovat s DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-GroupDetectionClauses
Když konfigurujete pravidla pro detekci přítomnosti tohoto typu nasazení, použijte tento parametr pro seskupení klauzulí. Chcete-li vytvořit klauzuli detekce, použijte jednu z následujících rutin:
- New-CMDetectionClauseDirectory
- New-CMDetectionClauseFile
- New-CMDetectionClauseRegistryKey
- New-CMDetectionClauseRegistryKeyValue
- New-CMDetectionClauseWindowsInstaller
Výstup těchto rutin uložte do proměnné. Pak použijte následující formát pro seskupení klauzulí: $clause2.Setting.LogicalName, $clause3.Setting.LogicalName
.
Tip
Když v konzole Configuration Manager vyberete akci skupiny , v klauzulích se před a za seskupené klauzule zobrazí závorky.
Type: String[]
Parameter Sets: (All)
Aliases: GroupDetectionClausesByLogicalName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
– Položky InputObject
Zadejte objekt typu nasazení, který chcete konfigurovat. K získání tohoto objektu použijte rutinu Get-CMDeploymentType .
Type: IResultObject
Parameter Sets: ByDTValue
Aliases: DeploymentType
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-InstallTaskSequenceId
ID pořadí úkolů pro instalaci aplikace
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InstallationBehaviorType
Zadejte chování instalace pro tento typ nasazení:
InstallForUser
: Klient nainstaluje aplikaci jenom pro uživatele, pro kterého aplikaci nasadíte.InstallForSystem
: Klient nainstaluje aplikaci jenom jednou. Je k dispozici pro všechny uživatele.InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser
: Pokud aplikaci nasadíte do zařízení, klient ji nainstaluje pro všechny uživatele. Pokud aplikaci nasadíte uživateli, klient ji nainstaluje jenom pro tohoto uživatele.
Type: InstallationBehaviorType
Parameter Sets: (All)
Aliases:
Accepted values: InstallForUser, InstallForSystem, InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-LogonRequirementType
Zadejte požadavek na přihlášené uživatele:
OnlyWhenNoUserLoggedOn
: Pouze v případě, že není přihlášený žádný Windows.OnlyWhenUserLoggedOn
: Jenom v případě, že je uživatel přihlášený. Tato možnost je výchozí.WhetherOrNotUserLoggedOn
: Určuje, jestli je uživatel přihlášený.Poznámka
Hodnota
WhereOrNotUserLoggedOn
je zastaralá. Nahradí jiWhetherOrNotUserLoggedOn
.
Pokud nastavíte InstallationBehaviorType na InstallForUser
, pak tento parametr nemůžete nastavit.
Type: LogonRequirementType
Parameter Sets: (All)
Aliases:
Accepted values: OnlyWhenUserLoggedOn, WhereOrNotUserLoggedOn, WhetherOrNotUserLoggedOn, OnlyWhenNoUserLoggedOn
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MaximumRuntimeMins
Zadejte maximální povolenou dobu běhu programu nasazení pro tuto aplikaci. Nastavte celočíselnou hodnotu v minutách.
Type: Int32
Parameter Sets: (All)
Aliases: MaximumAllowedRunTimeMinutes, MaximumAllowedRunTimeMins, MaximumRunTimeMinutes
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewName
Zadejte nový název pro přejmenování tohoto typu nasazení.
Type: String
Parameter Sets: (All)
Aliases: NewDeploymentTypeName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Přidáním tohoto parametru vrátíte objekt, který představuje položku, se kterou pracujete. Ve výchozím nastavení tato rutina nemusí generovat žádný výstup.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ProductCode
Pokud aplikace používá Windows instalačního programu, zadejte kód produktu MSI, který se nastaví jako metoda detekce. Když použijete tento parametr, přepíše všechny existující metody detekce.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RebootBehavior
Zadejte chování po instalaci:
BasedOnExitCode
: Určete chování na základě návratových kódů.NoAction
: Žádná konkrétní akce.ProgramReboot
: Instalační program softwaru může vynutit restartování zařízení.ForceReboot
: Správce konfigurace klient vynutí povinné restartování zařízení.
Další informace o těchto chováních najdete v tématu Vytváření aplikací v Správce konfigurace.
Type: PostExecutionBehavior
Parameter Sets: (All)
Aliases:
Accepted values: BasedOnExitCode, NoAction, ForceReboot, ProgramReboot
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoveDetectionClause
Zadejte pole klauzulí metody detekce, které se mají odebrat.
Type: String[]
Parameter Sets: (All)
Aliases: RemoveDetectionClauses
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoveLanguage
Zadejte pole podporovaných jazyků, které chcete z tohoto typu nasazení odebrat.
Type: String[]
Parameter Sets: (All)
Aliases: RemoveLanguages
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RemoveRequirement
Zadejte pole pravidel požadavků, která se mají z tohoto typu nasazení odebrat.
Type: Rule[]
Parameter Sets: (All)
Aliases: RemoveRequirements
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RequireUserInteraction
Pokud chcete uživatelům povolit zobrazení a interakci s instalací typu nasazení, nastavte tento $true
parametr na .
Type: Boolean
Parameter Sets: (All)
Aliases: RequiresUserInteraction
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ScriptFile
Zadejte soubor skriptu, který se má použít ke zjištění tohoto typu nasazení. Použijte také parametr ScriptLanguage.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ScriptLanguage
Pokud použijete parametry ScriptFile nebo ScriptText, použijte tento parametr k určení skriptovacího jazyka.
Type: ScriptLanguage
Parameter Sets: (All)
Aliases: ScriptType
Accepted values: PowerShell, VBScript, JavaScript
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ScriptText
Zadejte text skriptu, který tento typ nasazení zjistí. Použijte také parametr ScriptLanguage.
Další informace najdete v tématu O metodách detekce vlastních skriptů.
Type: String
Parameter Sets: (All)
Aliases: ScriptContent, Script
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SlowNetworkDeploymentMode
Pokud klient používá distribuční bod ze skupiny hranic souseda nebo výchozí skupiny hranic lokality, určete možnost nasazení:
DoNothing
: Nestahovat obsahDownload
: Stažení obsahu z distribučního bodu a místní spuštění
Type: ContentHandlingMode
Parameter Sets: (All)
Aliases:
Accepted values: DoNothing, Download
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UninstallTaskSequenceId
ID pořadí úkolů pro odinstalaci aplikace.
Type: String
Parameter Sets: (All)
Aliases: ContentLocation, UninstallId
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UserInteractionMode
Zadejte viditelnost instalačního programu:
Normal
: Typ nasazení běží v normálním režimu na základě výchozích hodnot systému a programu. Tento režim je výchozí.Minimized
: Typ nasazení se na klientských zařízeních spustí minimalizovaně. Uživatelé můžou vidět instalační aktivitu v oznamovací oblasti nebo na hlavním panelu.Maximized
: Typ nasazení se na klientských zařízeních spouští maximalizovaně. Uživatelé vidí všechny instalační aktivity.Hidden
: Typ nasazení se na klientských zařízeních spustí jako skrytý. Uživatelé neuvidí žádnou instalační aktivitu.
Type: UserInteractionMode
Parameter Sets: (All)
Aliases: InstallationProgramVisibility
Accepted values: Normal, Minimized, Maximized, Hidden
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespouštěl.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.