Set-CMTaskSequenceDeploymentType
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 daWhetherOrNotUserLoggedOn
.
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 contenutoDownload
: 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