Condividi tramite


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. Usare questo cmdlet per configurare un tipo di distribuzione della sequenza di attività in un'applicazione. Per altre informazioni, vedere Tipo di distribuzione della sequenza di attività.

Questo cmdlet ha una sintassi simile a quella del cmdlet Set-CMMsiDeploymentType per il 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 -UninstallCommand nel cmdlet 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. Aggiunge 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 a 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 con regole dei requisiti e 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, usare uno dei cmdlet seguenti:

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

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

Tipo:DetectionClause[]
Alias:AddDetectionClauses
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AddLanguage

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

Per altre informazioni e un elenco di tag di lingua, vedere Informazioni di riferimento sull'identificatore del codice del linguaggio windows (LCID).

Tipo:String[]
Alias:AddLanguages, Languages, Language
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AddRequirement

-Application

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

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ApplicationId

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

Tipo:Int32
Alias:CI_ID, CIId
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ApplicationName

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Comment

Specificare una descrizione facoltativa per il tipo di distribuzione.

Tipo:String
Alias:AdministratorComment
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeploymentTypeName

Specificare il nome del tipo di distribuzione da configurare.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DetectionClauseConnector

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

L'esempio seguente definisce il connettore OR : @{"LogicalName"=$clauseFile3.Setting.LogicalName;"Connector"="OR"}

Tipo:Hashtable[]
Alias:DetectionClauseConnectors
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EstimatedRuntimeMins

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

Tipo:Int32
Alias:EstimatedInstallationTimeMinutes, EstimatedInstallationTimeMins, EstimatedRunTimeMinutes
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

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

Tipo:SwitchParameter
Alias:ForceForUnknownPublisher
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceScriptDetection32Bit

Se si usa 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 nei client a $true 64 bit.

Tipo:Boolean
Alias:Force32BitDetectionScript
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-GroupDetectionClauses

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

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

Consiglio

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

Tipo:String[]
Alias:GroupDetectionClausesByLogicalName
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

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

Tipo:IResultObject
Alias:DeploymentType
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-InstallationBehaviorType

Specificare il comportamento di installazione per questo tipo di distribuzione:

  • InstallForUser: il client installa l'applicazione solo 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 si distribuisce l'applicazione in un dispositivo, il client la installa per tutti gli utenti. Se si distribuisce l'applicazione a un utente, il client lo installa solo per tale utente.
Tipo:InstallationBehaviorType
Valori accettati:InstallForUser, InstallForSystem, InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InstallTaskSequenceId

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-LogonRequirementType

Specificare il requisito per un utente connesso:

  • OnlyWhenNoUserLoggedOn: solo quando nessun utente è connesso a Windows.

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

  • WhetherOrNotUserLoggedOn: indica se un utente ha eseguito o meno l'accesso.

    Nota

    Il valore WhereOrNotUserLoggedOn è deprecato. Viene sostituito da WhetherOrNotUserLoggedOn.

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

Tipo:LogonRequirementType
Valori accettati:OnlyWhenUserLoggedOn, WhereOrNotUserLoggedOn, WhetherOrNotUserLoggedOn, OnlyWhenNoUserLoggedOn
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MaximumRuntimeMins

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

Tipo:Int32
Alias:MaximumAllowedRunTimeMinutes, MaximumAllowedRunTimeMins, MaximumRunTimeMinutes
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NewName

Specificare un nuovo nome per rinominare questo tipo di distribuzione.

Tipo:String
Alias:NewDeploymentTypeName
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ProductCode

Se l'applicazione usa la tecnologia Windows Installer, specificare un codice del prodotto MSI da impostare come metodo di rilevamento. Quando si usa questo parametro, sovrascrive tutti i metodi di rilevamento esistenti.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 software potrebbe forzare il riavvio del dispositivo.

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

Per altre informazioni su questi comportamenti, vedere Creare applicazioni in Configuration Manager.

Tipo:PostExecutionBehavior
Valori accettati:BasedOnExitCode, NoAction, ForceReboot, ProgramReboot
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveDetectionClause

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

Tipo:String[]
Alias:RemoveDetectionClauses
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveLanguage

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

Tipo:String[]
Alias:RemoveLanguages
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveRequirement

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

Tipo:Rule[]
Alias:RemoveRequirements
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RequireUserInteraction

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

Tipo:Boolean
Alias:RequiresUserInteraction
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ScriptFile

Specificare il file di script da usare per rilevare questo tipo di distribuzione. Usare anche il parametro ScriptLanguage .

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ScriptLanguage

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

Tipo:ScriptLanguage
Alias:ScriptType
Valori accettati:PowerShell, VBScript, JavaScript
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ScriptText

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

Per altre informazioni, vedere Informazioni sui metodi di rilevamento degli script personalizzati.

Tipo:String
Alias:ScriptContent, Script
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SlowNetworkDeploymentMode

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

  • DoNothing: non scaricare il contenuto
  • Download: scaricare il contenuto dal punto di distribuzione ed eseguirlo in locale
Tipo:ContentHandlingMode
Valori accettati:DoNothing, Download
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UninstallTaskSequenceId

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

Tipo:String
Alias:ContentLocation, UninstallId
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 visualizzano alcuna attività di installazione.
Tipo:UserInteractionMode
Alias:InstallationProgramVisibility
Valori accettati:Normal, Minimized, Maximized, Hidden
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object