Set-CMTaskSequenceDeploymentType

Modulo:

ConfigurationManager

Configurare un tipo di distribuzione della sequenza di attività in un'applicazione.

Sintassi

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>]

Descrizione

Si applica alla versione 2006 e successive. Utilizzare questo cmdlet per configurare un tipo di distribuzione della sequenza di attività in un'applicazione. Per ulteriori informazioni, vedere Task sequence deployment type.

Questo cmdlet ha una sintassi simile a quella del cmdlet set-CMMsiDeploymentTypedel tipo di distribuzione MSI. Le differenze principali sono i parametri seguenti:

• -InstallTaskSequenceId <string> (obbligatorio): ID della sequenza di attività per installare l'app

• -UninstallTaskSequenceId <string> (facoltativo): ID della sequenza di attività per disinstallare l'app

Questi due parametri sono correlati alle opzioni della sequenza di attività del tipo di distribuzione. Sostituiscono i -InstallCommand parametri e nel cmdlet -UninstallCommand MSI.

Esempio

Esempio 1: Modificare un tipo di distribuzione della sequenza di attività

Questo comando modifica il nome del tipo di distribuzione da Installazione complessa a Installazione avanzata. Vengono aggiunti l'inglese (Stati Uniti) ( en-US ) e il cinese (semplificato) ( zh-CN ) come lingue supportate. Specifica che l'installazione richiederà circa 14 minuti e verrà eseguita solo quando nessun utente ha eseguito l'accesso 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

Per altri esempi relativi alle regole dei requisiti e ai metodi di rilevamento, vedere Set-CMScriptDeploymentType e Add-CMMsiDeploymentType.

Parametri

-AddDetectionClause

Specificare una matrice di clausole del metodo di rilevamento per questo tipo di distribuzione. Per creare una clausola di rilevamento, utilizzare uno dei cmdlet seguenti:

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

Salvare l'output di questi cmdlet in una variabile. Specificare quindi tali variabili come matrice per questo parametro. Ad esempio, -AddDetectionClause $clauseFile1,$clauseFile2,$clauseFile3.

È inoltre possibile utilizzare Get-CMDeploymentTypeDetectionClause per ottenere una clausola di rilevamento esistente da un'altra applicazione.

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

-AddLanguage

Specificare una matrice di tag di lingua supportati dal tipo di distribuzione. Ad esempio, per aggiungere russo (Russia), specificare il tag ru-RU .

Per ulteriori informazioni e un elenco di tag di lingua, vedere Windows Riferimento LCID (Language Code Identifier).

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

-AddRequirement

Specificare una matrice di oggetti requisito per il tipo di distribuzione. Per creare un oggetto regola requisito, utilizzare uno dei cmdlet seguenti:

• 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

A partire dalla versione 2111, è possibile utilizzare il cmdlet Get-CMDeploymentTypeRequirement per copiare le regole da un altro tipo di distribuzione.

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

-Application

Specificare un oggetto applicazione per questo tipo di distribuzione. Per ottenere questo oggetto, utilizzare il cmdlet Get-CMApplication.

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

-ApplicationId

Specificare l'ID dell'applicazione per questo tipo di distribuzione.

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

-ApplicationName

Specificare il nome dell'applicazione per questo tipo di distribuzione.

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

-Comment

Specificare una descrizione facoltativa per il tipo di distribuzione.

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

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

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

-DeploymentTypeName

Specificare il nome del tipo di distribuzione da configurare.

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

-DetectionClauseConnector

Quando si utilizza il parametro GroupDetectionClauses per raggruppare le clausole di rilevamento, utilizzare questo parametro per specificare il connettore.

Nell'esempio seguente viene definito il connettore 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

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

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

-EstimatedRuntimeMins

Specificare il tempo stimato di installazione, in minuti, di questo tipo di distribuzione per l'applicazione. Software Center visualizza questa stima all'utente prima dell'installazione dell'applicazione.

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

-Force

Forza l'esecuzione del comando senza richiedere la conferma dell'utente.

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

-ForceScriptDetection32Bit

Se si utilizza uno script personalizzato per rilevare la presenza di questo tipo di distribuzione, impostare questo parametro su per eseguire lo script come processo a 32 bit su client $true a 64 bit.

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

-ForceWildcardHandling

Questo parametro elabora i caratteri jolly e può causare un comportamento imprevisto (scelta non consigliata). Non è possibile combinarlo con DisableWildcardHandling.

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

-GroupDetectionClauses

Quando si configurano le regole per rilevare la presenza di questo tipo di distribuzione, utilizzare questo parametro per raggruppare le clausole. Per creare una clausola di rilevamento, utilizzare uno dei cmdlet seguenti:

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

Salvare l'output di questi cmdlet in una variabile. Utilizzare quindi il formato seguente per raggruppare le clausole: $clause2.Setting.LogicalName, $clause3.Setting.LogicalName .

Suggerimento

Nella console di Configuration Manager, **** quando si seleziona l'azione Gruppo, le clausole mostrano le parentesi prima e dopo le clausole raggruppate.

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

-InputObject

Specificare un oggetto tipo di distribuzione da configurare. Per ottenere questo oggetto, utilizzare il cmdlet Get-CMDeploymentType.

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

-InstallationBehaviorType

Specificare il comportamento di installazione per questo tipo di distribuzione:

• InstallForUser: il client installa solo l'applicazione per l'utente a cui si distribuisce l'applicazione.
• InstallForSystem: il client installa l'applicazione una sola volta. È disponibile per tutti gli utenti.
• InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser: se distribuisci l'applicazione in un dispositivo, il client la installa per tutti gli utenti. Se si distribuisce l'applicazione a un utente, il client la installa solo per tale utente.

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

-InstallTaskSequenceId

ID della sequenza di attività per installare l'app.

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

-LogonRequirementType

Specificare il requisito per un utente connesso:

• OnlyWhenNoUserLoggedOn: solo quando nessun utente è connesso Windows.

• OnlyWhenUserLoggedOn: solo quando un utente ha eseguito l'accesso. Questa è l'opzione predefinita.

• WhetherOrNotUserLoggedOn: indica se un utente è connesso o meno.

  Nota

  Il valore WhereOrNotUserLoggedOn è deprecato. Viene sostituito da WhetherOrNotUserLoggedOn .

Se si imposta InstallationBehaviorType su InstallForUser , non è possibile impostare questo parametro.

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

-MaximumRuntimeMins

Specificare il tempo di esecuzione massimo consentito del programma di distribuzione per questa applicazione. Impostare un valore intero in minuti.

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

-NewName

Specificare un nuovo nome per rinominare questo tipo di distribuzione.

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

-PassThru

Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.

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

-ProductCode

Se l'applicazione utilizza Windows Installer, specificare un codice di prodotto MSI da impostare come metodo di rilevamento. Quando si utilizza questo parametro, vengono sovrascritti tutti i metodi di rilevamento esistenti.

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

-RebootBehavior

Specificare il comportamento post-installazione:

• BasedOnExitCode: Determinare il comportamento in base ai codici restituiti.

• NoAction: nessuna azione specifica.

• ProgramReboot: il programma di installazione del software potrebbe forzare il riavvio del dispositivo.

• ForceReboot: il client di Configuration Manager forza un riavvio obbligatorio del dispositivo.

Per ulteriori informazioni su questi comportamenti, vedere Create applications 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

Specificare una matrice di clausole del metodo di rilevamento da rimuovere.

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

-RemoveLanguage

Specificare una matrice di lingue supportate da rimuovere da questo tipo di distribuzione.

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

-RemoveRequirement

Specificare una matrice di regole dei requisiti da rimuovere da questo tipo di distribuzione.

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

-RequireUserInteraction

Impostare questo parametro su per $true consentire agli utenti di visualizzare e interagire con l'installazione del tipo di distribuzione.

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

-ScriptFile

Specificare il file di script da utilizzare per rilevare questo tipo di distribuzione. Utilizzare anche il parametro ScriptLanguage.

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

-ScriptLanguage

Se si utilizzano i parametri ScriptFile o ScriptText, utilizzare questo parametro per specificare il linguaggio di script.

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

-ScriptText

Specificare il testo di uno script per rilevare questo tipo di distribuzione. Utilizzare anche il parametro ScriptLanguage.

Per ulteriori informazioni, vedere About custom script detection methods.

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

-SlowNetworkDeploymentMode

Quando un client utilizza un punto di distribuzione da un gruppo di limiti adiacenti o dal gruppo di limiti del sito predefinito, specificare l'opzione di distribuzione:

• DoNothing: non scaricare contenuto
• Download: scaricare il contenuto dal punto di distribuzione ed eseguirlo in locale

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

-UninstallTaskSequenceId

ID della sequenza di attività per disinstallare l'app.

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

-UserInteractionMode

Specificare la visibilità del programma di installazione:

• Normal: il tipo di distribuzione viene eseguito in modalità normale in base alle impostazioni predefinite del sistema e del programma. Questa modalità è l'impostazione predefinita.
• Minimized: il tipo di distribuzione viene eseguito ridotto a icona nei dispositivi client. Gli utenti potrebbero visualizzare l'attività di installazione nell'area di notifica o nella barra delle applicazioni.
• Maximized: il tipo di distribuzione viene eseguito ingrandito nei dispositivi client. Gli utenti visualizzano tutte le attività di installazione.
• Hidden: il tipo di distribuzione viene eseguito nascosto nei dispositivi client. Gli utenti non vedono alcuna attività di installazione.

Type:	UserInteractionMode
Aliases:	InstallationProgramVisibility
Accepted values:	Normal, Minimized, Maximized, Hidden
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

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

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object

Collegamenti correlati

• Add-CMTaskSequenceDeploymentType
• Get-CMDeploymentType
• Remove-CMDeploymentType
• Get-CMApplication
• Tipo di distribuzione della sequenza di attività