Set-CMTaskSequenceDeploymentType

Artikel
08/17/2021

SYNOPSIS

Konfigurera en aktivitetssekvensdistributionstyp för ett program.

SYNTAX

ByAppName (standard)

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

Gäller för version 2006 och senare. Använd den här cmdleten för att konfigurera en aktivitetssekvensdistributionstyp för ett program. Mer information finns i Distributionstypen Aktivitetssekvens.

Den här cmdleten har liknande syntax som MSI-distributionstypen cmdlet Set-CMMsiDeploymentType. De främsta skillnaderna är följande parametrar:

-InstallTaskSequenceId <string> (krävs): ID:t för aktivitetssekvensen för att installera appen
-UninstallTaskSequenceId <string> (valfritt): ID:t för aktivitetssekvensen för att avinstallera appen

Dessa två parametrar är relaterade till distributionstypsalternativen för aktivitetssekvensen. De ersätter -InstallCommand -UninstallCommand parametrarna och på MSI-cmdleten.

EXAMPLES

Exempel 1: Ändra en aktivitetssekvensdistributionstyp

Det här kommandot ändrar namnet på distributionstypen från Komplex installation till Avancerad installation. Den lägger till engelska (USA) ( en-US ) och kinesiska (förenklad) ( zh-CN ) som språk som stöds. Den anger att installationen tar cirka 14 minuter att slutföra och körs bara när inga användare är inloggade 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

Andra exempel med kravregler och identifieringsmetoder finns i Set-CMScriptDeploymentType och Add-CMMsiDeploymentType.

PARAMETERS

-AddDetectionClause

Ange en matris med satser för identifieringsmetod för den här distributionstypen. Använd någon av följande cmdlets för att skapa en identifieringssats:

Spara utdata för dessa cmdlets i en variabel. Ange sedan dessa variabler som en matris för den här parametern. Till exempel -AddDetectionClause $clauseFile1,$clauseFile2,$clauseFile3.

Du kan också använda Get-CMDeploymentTypeDetectionClause för att hämta en befintlig identifieringssats från ett annat program.

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

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

-AddLanguage

Ange en matris med språktaggar som distributionstypen stöder. Om du till exempel vill lägga till ryska (Ryssland) anger du taggen ru-RU .

Mer information och en lista över språktaggar finns i Windows LCID-referens (Language Code Identifier).

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

Ange en matris med kravobjekt för distributionstypen. Om du vill skapa ett kravregelobjekt använder du någon av följande cmdlets:

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

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

-Program

Ange ett programobjekt för den här distributionstypen. Hämta det här objektet med cmdleten Get-CMApplication.

Type: IResultObject
Parameter Sets: ByAppValue
Aliases:

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

-ApplicationId

Ange ID för programmet för den här distributionstypen.

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

Ange namnet på programmet för den här distributionstypen.

Type: String
Parameter Sets: ByAppName
Aliases:

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

-Kommentar

Ange en valfri beskrivning av distributionstypen.

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

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

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

-DeploymentTypeName

Ange namnet på den distributionstyp som ska konfigureras.

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

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

-DetectionClauseConnector

När du använder parametern GroupDetectionClauses för att gruppera satser för identifiering använder du den här parametern för att ange anslutningsappen.

I följande exempel definieras OR-anslutningsappen:@{"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

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EstimatedRuntimeMins

Ange den uppskattade installationstiden, i minuter, för den här distributionstypen för programmet. Software Center visar den här uppskattningen för användaren innan programmet installeras.

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

Tvingar kommandot att köras utan att be om användarbekräftelse.

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

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

-ForceScriptDetection32Bit

Om du använder ett anpassat skript för att identifiera förekomsten av den här distributionstypen anger du den här parametern till för att köra skriptet som en $true 32-bitarsprocess på 64-bitarsklienter.

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

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-GroupDetectionClauses

När du konfigurerar regler för att identifiera förekomst av den här distributionstypen använder du den här parametern för att gruppera satser. Använd någon av följande cmdlets för att skapa en identifieringssats:

Spara utdata för dessa cmdlets i en variabel. Använd sedan följande format för att gruppera satser: $clause2.Setting.LogicalName, $clause3.Setting.LogicalName .

Tips

När du Konfigurationshanteraren gruppåtgärden i konsolen visas parenteser före och efter de grupperade satserna i satserna.

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

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

-InputObject

Ange ett distributionstypsobjekt som ska konfigureras. Hämta det här objektet med cmdleten 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 för aktivitetssekvensen för att installera appen.

Type: String
Parameter Sets: (All)
Aliases:

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

-InstallationBehaviorType

Ange installationsbeteendet för den här distributionstypen:

InstallForUser: Klienten installerar bara programmet för den användare som du distribuerar programmet till.
InstallForSystem: Klienten installerar programmet bara en gång. Den är tillgänglig för alla användare.
InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser: Om du distribuerar programmet till en enhet installerar klienten det för alla användare. Om du distribuerar programmet till en användare installerar klienten det bara för den användaren.

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

Ange kravet för en inloggad användare:

OnlyWhenNoUserLoggedOn: Endast när ingen användare är inloggad Windows.
OnlyWhenUserLoggedOn: Endast när en användare är inloggad. Det här alternativet är standardinställningen.
WhetherOrNotUserLoggedOn: Oavsett om en användare är inloggad eller inte.

Anteckning

Värdet WhereOrNotUserLoggedOn är inaktuellt. Den ersätts av WhetherOrNotUserLoggedOn .

Om du anger InstallationBehaviorType till InstallForUser kan du inte ange den här parametern.

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

Ange den högsta tillåtna körningstiden för distributionsprogrammet för det här programmet. Ange ett heltalsvärde i minuter.

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

Ange ett nytt namn för att byta namn på den här distributionstypen.

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

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

-PassThru

Lägg till den här parametern för att returnera ett objekt som representerar det objekt som du arbetar med. Som standard genererar den här cmdleten kanske inte några utdata.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ProductCode

Om programmet använder Windows Installer-teknik anger du en MSI-produktkod som ska anges som identifieringsmetod. När du använder den här parametern skriver den över alla befintliga identifieringsmetoder.

Type: String
Parameter Sets: (All)
Aliases:

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

-RebootBehavior

Ange beteendet efter installationen:

BasedOnExitCode: Fastställa beteende baserat på returkoder.
NoAction: Ingen specifik åtgärd.
ProgramReboot: Programmet för programinstallation kan tvinga fram en omstart av enheten.
ForceReboot: Konfigurationshanteraren klient tvingar fram en obligatorisk omstart av enheten.

Mer information om dessa beteenden finns i Skapa program i Konfigurationshanteraren.

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

Ange en matris med satser för identifieringsmetod som ska tas bort.

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

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

-RemoveLanguage

Ange en matris med språk som stöds för att ta bort från den här distributionstypen.

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

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

-RemoveRequirement

Ange en matris med kravregler som ska tas bort från den här distributionstypen.

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

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

-RequireUserInteraction

Ange den här $true parametern till så att användarna kan visa och interagera med distributionstypsinstallationen.

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

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

-ScriptFile

Ange den skriptfil som ska användas för att identifiera den här distributionstypen. Använd även parametern ScriptLanguage.

Type: String
Parameter Sets: (All)
Aliases:

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

-ScriptLanguage

Om du använder parametrarna ScriptFile eller ScriptText använder du den här parametern för att ange skriptspråket.

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

Ange texten i ett skript för att identifiera den här distributionstypen. Använd även parametern ScriptLanguage.

Mer information finns i Om metoder för identifiering av anpassade 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

När en klient använder en distributionsplats från en granngränsgrupp eller standardplatsgränsgruppen anger du distributionsalternativet:

DoNothing: Ladda inte ned innehåll
Download: Ladda ned innehåll från distributionsplatsen och kör lokalt

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:t för aktivitetssekvensen för att avinstallera appen.

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

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

-UserInteractionMode

Ange synligheten för installationsprogrammet:

Normal: Distributionstypen körs i normalt läge baserat på systemets och programmets standardinställningar. Det här är standardläget.
Minimized: Distributionstypen körs minimerat på klientenheter. Användarna kan se installationsaktiviteten i meddelandefältet eller aktivitetsfältet.
Maximized: Distributionstypen körs maximerat på klientenheter. Användarna ser all installationsaktivitet.
Hidden: Distributionstypen körs dolt på klientenheter. Användarna ser ingen installationsaktivitet.

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

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

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

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

ANTECKNINGAR

Add-CMTaskSequenceDeploymentType

Get-CMDeploymentType

Remove-CMDeploymentType

Get-CMApplication

Distributionstypen Aktivitetssekvens

Dela via