Set-CMTaskSequenceDeploymentType

SYNOPSIS

Configureer een takenreeksimplementatietype voor een toepassing.

SYNTAX

ByAppName (standaard)

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

Is van toepassing op versie 2006 en hoger. Gebruik deze cmdlet om een implementatietype voor een takenreeks te configureren voor een toepassing. Zie Implementatietype takenreeks voor meer informatie.

Deze cmdlet heeft een vergelijkbare syntaxis als het MSI-implementatietype cmdlet Set-CMMsiDeploymentType. De belangrijkste verschillen zijn de volgende parameters:

• -InstallTaskSequenceId <string> (vereist): de id van de takenreeks voor het installeren van de app

• -UninstallTaskSequenceId <string> (optioneel): de id van de takenreeks voor het verwijderen van de app

Deze twee parameters hebben betrekking op de takenreeksopties van het implementatietype. Ze vervangen de -InstallCommand parameters en op de -UninstallCommand MSI-cmdlet.

EXAMPLES

Voorbeeld 1: een implementatietype voor een takenreeks wijzigen

Met deze opdracht wordt de naam van het implementatietype gewijzigd van Complex installeren in Geavanceerde installatie. Hiermee wordt Engels (Verenigde Staten) ( en-US ) en Chinees (vereenvoudigd) ( ) toegevoegd zh-CN als ondersteunde talen. Hiermee wordt aangegeven dat het ongeveer 14 minuten duurt voordat de installatie is voltooid en alleen wordt uitgevoerd wanneer er geen gebruikers zijn aangemeld bij 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

Zie Set-CMScriptDeploymentType en Add-CMMsiDeploymentTypevoor andere voorbeelden met vereisteregels en detectiemethoden.

PARAMETERS

-AddDetectionKlause

Geef een matrix met detectiemethodeclausules op voor dit implementatietype. Gebruik een van de volgende cmdlets om een detectieclausule te maken:

• New-CMDetectionDirectory
• New-CMDetection ClauseFile
• New-CMDetectionRegistryKey
• New-CMDetectionRegistryKeyValue
• New-CMDetectionClauseWindowsInstaller

Sla de uitvoer van deze cmdlets op in een variabele. Geef deze variabelen vervolgens op als een matrix voor deze parameter. Bijvoorbeeld -AddDetectionClause $clauseFile1,$clauseFile2,$clauseFile3.

U kunt ook Get-CMDeploymentTypeDetectionClause gebruiken om een bestaande detectieclausule op te halen uit een andere toepassing.

Type: DetectionClause[]
Parameter Sets: (All)
Aliases: AddDetectionClauses

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

-AddLanguage

Geef een matrix met taaltags op die door het implementatietype worden ondersteund. Als u bijvoorbeeld Russisch (Rusland) wilt toevoegen, geeft u de tag ru-RU op.

Zie naslaginformatie voor Windows Language Code Identifier (LCID)voor meer informatie en een lijst met taaltags.

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

Geef een matrix met vereisteobjecten op voor het implementatietype. Gebruik een van de volgende cmdlets om een vereisteregelobject te maken:

• 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

-Application

Geef een toepassingsobject op voor dit implementatietype. Gebruik de cmdlet Get-CMApplication om dit object op te halen.

Type: IResultObject
Parameter Sets: ByAppValue
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ApplicationId

Geef de id van de toepassing voor dit implementatietype op.

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

Geef de naam op van de toepassing voor dit implementatietype.

Type: String
Parameter Sets: ByAppName
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Opmerking

Geef een optionele beschrijving op voor het implementatietype.

Type: String
Parameter Sets: (All)
Aliases: AdministratorComment

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-DeploymentTypeName

Geef de naam op van het implementatietype dat u wilt configureren.

Type: String
Parameter Sets: ByAppName, ByAppValue, ByAppId
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DetectionClauseConnector

Wanneer u de parameter GroupDetectionParauses gebruikt om detectieclausules te groeperen, gebruikt u deze parameter om de connector op te geven.

In het volgende voorbeeld wordt de OR-connector definieert:@{"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

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EstimatedRuntimeMins

Geef de geschatte installatietijd (in minuten) van dit implementatietype voor de toepassing op. Software Center geeft deze schatting aan de gebruiker weer voordat de toepassing wordt geïnstalleerd.

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

Dwingt de opdracht uit te voeren zonder te vragen om bevestiging van de gebruiker.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: ForceForUnknownPublisher

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

-ForceScriptDetection32Bit

Als u een aangepast script gebruikt om de aanwezigheid van dit implementatietype te detecteren, stelt u deze parameter in op om het script uit te voeren als $true een 32-bits proces op 64-bits clients.

Type: Boolean
Parameter Sets: (All)
Aliases: Force32BitDetectionScript

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

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-GroupDetection Clauses

Wanneer u regels configureert om de aanwezigheid van dit implementatietype te detecteren, gebruikt u deze parameter om component te groeperen. Gebruik een van de volgende cmdlets om een detectieclausule te maken:

• New-CMDetectionDirectory
• New-CMDetection ClauseFile
• New-CMDetectionRegistryKey
• New-CMDetectionRegistryKeyValue
• New-CMDetectionClauseWindowsInstaller

Sla de uitvoer van deze cmdlets op in een variabele. Gebruik vervolgens de volgende indeling om component te groepen: $clause2.Setting.LogicalName, $clause3.Setting.LogicalName .

Tip

Wanneer u Configuration Manager de actie Groep selecteert, tonen de components haakjes vóór en na de gegroepeerde component.

Type: String[]
Parameter Sets: (All)
Aliases: GroupDetectionClausesByLogicalName

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

-InputObject

Geef een implementatietypeobject op dat u wilt configureren. Gebruik de cmdlet Get-CMDeploymentType om dit object op te halen.

Type: IResultObject
Parameter Sets: ByDTValue
Aliases: DeploymentType

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-InstallTaskSequenceId

De id van de takenreeks voor het installeren van de app.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InstallationBehaviorType

Geef het installatiegedrag voor dit implementatietype op:

• InstallForUser: De client installeert alleen de toepassing voor de gebruiker voor wie u de toepassing implementeert.
• InstallForSystem: De client installeert de toepassing slechts één keer. Het is beschikbaar voor alle gebruikers.
• InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser: Als u de toepassing op een apparaat implementeert, installeert de client deze voor alle gebruikers. Als u de toepassing implementeert voor een gebruiker, installeert de client deze alleen voor die gebruiker.

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

Geef de vereiste voor een aangemelde gebruiker op:

• OnlyWhenNoUserLoggedOn: Alleen wanneer er geen gebruiker is aangemeld bij Windows.

• OnlyWhenUserLoggedOn: Alleen wanneer een gebruiker is aangemeld. Dit is de standaardoptie.

• WhetherOrNotUserLoggedOn: Of een gebruiker is aangemeld.

  Notitie

  De waarde WhereOrNotUserLoggedOn is afgeschaft. Deze wordt vervangen door WhetherOrNotUserLoggedOn .

Als u InstallationBehaviorType in stelt op , kunt u deze parameter niet InstallForUser instellen.

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

Geef de maximaal toegestane run time van het implementatieprogramma voor deze toepassing op. Stel een geheel getal in minuten in.

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

Geef een nieuwe naam op om de naam van dit implementatietype te wijzigen.

Type: String
Parameter Sets: (All)
Aliases: NewDeploymentTypeName

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

-PassThru

Voeg deze parameter toe om een -object te retourneren dat het item vertegenwoordigt waarmee u werkt. Standaard is het mogelijk dat deze cmdlet geen uitvoer genereert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ProductCode

Als de toepassing gebruikmaakt van Windows Installer-technologie, geeft u een MSI-productcode op die moet worden ingesteld als de detectiemethode. Wanneer u deze parameter gebruikt, worden alle bestaande detectiemethoden overschreven.

Type: String
Parameter Sets: (All)
Aliases:

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

-RebootBehavior

Geef het gedrag na de installatie op:

• BasedOnExitCode: Gedrag bepalen op basis van retourcodes.

• NoAction: Geen specifieke actie.

• ProgramReboot: Het software-installatieprogramma kan het opnieuw opstarten van een apparaat forceer.

• ForceReboot: Configuration Manager-client dwingt het opnieuw opstarten van het apparaat af.

Zie Toepassingen maken in Configuration Manager voor meer informatie over Configuration Manager.

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

Geef een matrix van detectiemethodeclausules op die moeten worden verwijderd.

Type: String[]
Parameter Sets: (All)
Aliases: RemoveDetectionClauses

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

-RemoveLanguage

Geef een matrix met ondersteunde talen op die moeten worden verwijderd uit dit implementatietype.

Type: String[]
Parameter Sets: (All)
Aliases: RemoveLanguages

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

-RemoveRequirement

Geef een matrix met vereisteregels op die moeten worden verwijderd uit dit implementatietype.

Type: Rule[]
Parameter Sets: (All)
Aliases: RemoveRequirements

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

-RequireUserInteraction

Stel deze parameter in op $true zodat gebruikers de installatie van het implementatietype kunnen bekijken en gebruiken.

Type: Boolean
Parameter Sets: (All)
Aliases: RequiresUserInteraction

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

-ScriptFile

Geef het scriptbestand op dat moet worden gebruikt om dit implementatietype te detecteren. Gebruik ook de parameter ScriptLanguage.

Type: String
Parameter Sets: (All)
Aliases:

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

-ScriptLanguage

Als u de parameters ScriptFile of ScriptText gebruikt, gebruikt u deze parameter om de scripttaal op te geven.

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

Geef de tekst van een script op om dit implementatietype te detecteren. Gebruik ook de parameter ScriptLanguage.

Zie Over aangepaste scriptdetectiemethoden voor meer informatie.

Type: String
Parameter Sets: (All)
Aliases: ScriptContent, Script

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

-SlowNetworkDeploymentMode

Wanneer een client een distributiepunt van een grensgroep van de aangrenzende of de standaardsitegrensgroep gebruikt, geeft u de implementatieoptie op:

• DoNothing: Inhoud niet downloaden
• Download: Inhoud downloaden van het distributiepunt en lokaal uitvoeren

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

De id van de takenreeks voor het verwijderen van de app.

Type: String
Parameter Sets: (All)
Aliases: ContentLocation, UninstallId

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

-UserInteractionMode

Geef de zichtbaarheid van het installatieprogramma op:

• Normal: Het implementatietype wordt uitgevoerd in de normale modus op basis van de standaardinstellingen van het systeem en programma. Deze modus is de standaardinstelling.
• Minimized: Het implementatietype wordt geminimaliseerd uitgevoerd op clientapparaten. Gebruikers kunnen de installatieactiviteit zien in het systeemsysteemgebied of de taakbalk.
• Maximized: Het implementatietype wordt gemaximaliseerd uitgevoerd op clientapparaten. Gebruikers zien alle installatieactiviteiten.
• Hidden: Het implementatietype wordt verborgen uitgevoerd op clientapparaten. Gebruikers zien geen installatieactiviteit.

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

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

OPMERKINGEN

RELATED LINKS

Add-CMTaskSequenceDeploymentType

Get-CMDeploymentType

Remove-CMDeploymentType

Get-CMApplication

Implementatietype takenreeks