Condividi tramite

New-CMTaskSequencePhase

  • Riferimento
Modulo:
ConfigurationManager

Usare questo cmdlet per creare una fase di distribuzione per una sequenza di attività.

Sintassi

New-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-Collection] <IResultObject>
   [-Comments <String>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InstallationChoice <InstallationChoiceType>]
   -PhaseName <String>
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-ThrottlingDays <Int32>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CollectionId] <String>
   [-Comments <String>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InstallationChoice <InstallationChoiceType>]
   -PhaseName <String>
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-ThrottlingDays <Int32>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CollectionName] <String>
   [-Comments <String>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InstallationChoice <InstallationChoiceType>]
   -PhaseName <String>
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-ThrottlingDays <Int32>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per creare una fase di distribuzione per una sequenza di attività.

Esempio

Esempio 1: Creare una fase della sequenza di attività

In questo esempio viene creata una fase della sequenza di attività denominata MyTSPhase per la raccolta denominata MyCollection.

New-CMTaskSequencePhase -CollectionName "MyCollection" -PhaseName "MyTSPhase" -UserNotification DisplayAll -AllowRemoteDP $true

Parametri

-AllowFallback

Questo parametro è uguale all'impostazione seguente nella pagina Punti di distribuzionedell'Aggiunta guidata fase nella console: Consentire ai client di usare i punti di distribuzione del gruppo di limiti del sito predefinito.

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

-AllowRemoteDP

Questo parametro è uguale all'impostazione seguente nella pagina Punti di distribuzionedell'Aggiunta guidata fase nella console: quando non è disponibile alcun punto di distribuzione locale, usare un punto di distribuzione remoto.

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

-AllowSystemRestart

Questo parametro è uguale all'impostazione seguente nella pagina Esperienza utentedell'Aggiunta guidata fase nella console: Riavvio del sistema (se necessario per completare l'installazione). Questa impostazione si applica quando viene raggiunta la scadenza dell'installazione, per consentire l'esecuzione di questa attività all'esterno della finestra di manutenzione.

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

-BeginCondition

Specificare un'opzione per iniziare questa fase di distribuzione dopo l'esito positivo della fase precedente:

  • AfterPeriod: questo parametro è uguale all'impostazione seguente nella pagina Impostazioni fasedell'Aggiunta guidata fase nella console: iniziare automaticamente questa fase dopo un periodo di differimento (in giorni). Se si specifica questo valore, usare DaysAfterPreviousPhaseSuccess per configurare il periodo di tempo.

  • Manually: questo parametro è uguale all'impostazione seguente nella pagina Impostazioni fasedell'Aggiunta guidata fase nella console: Iniziare manualmente questa fase di distribuzione.

Tipo:BeginConditionType
Valori accettati:AfterPeriod, Manually
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Collection

Specificare un oggetto per la raccolta di destinazione

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

-CollectionId

Specificare la raccolta di destinazione in base all'ID.

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

-CollectionName

Specificare la raccolta di destinazione in base al nome.

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

-Comments

Specificare i commenti facoltativi per questa fase. La lunghezza massima è di 512 caratteri.

Tipo:String
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

-CriteriaOption

Specificare un'opzione per scegliere i criteri per l'esito positivo della fase precedente:

  • Compliance: questo parametro corrisponde all'impostazione seguente nella pagina Impostazioni fasedell'Aggiunta guidata fase nella console: Percentuale di esito positivo della distribuzione. Specificare il valore percentuale con il parametro CriteriaValue .

  • Number: questo parametro è uguale all'impostazione seguente nella pagina Impostazioni fasedell'Aggiunta guidata fase nella console: Numero di dispositivi distribuiti correttamente. Specificare il numero di dispositivi con il parametro CriteriaValue .

Tipo:CriteriaType
Valori accettati:Compliance, Number
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CriteriaValue

Questo valore intero dipende dal valore specificato per CriteriaOption:

  • Compliance: specificare la percentuale

  • Number: specificare il numero di dispositivi

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

-DaysAfterPreviousPhaseSuccess

Specificare un valore intero per il numero di giorni successivi all'esito positivo della fase precedente per iniziare questa fase. Questo parametro è lo stesso dell'impostazione seguente nella pagina Impostazioni fasedell'Aggiunta guidata fase nella console: iniziare automaticamente questa fase dopo un periodo di differimento (in giorni).

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

-DeadlineUnit

Specificare il tipo di periodo di scadenza. Usare questo parametro con DeadlineValue.

Tipo:TimeUnitType
Valori accettati:Hours, Days, Weeks, Months
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeadlineValue

Questo parametro viene utilizzato solo se si specifica AfterPeriod con il parametro InstallationChoice .

Specificare un valore intero per il periodo di tempo per la scadenza. Utilizzare il parametro DeadlineUnit per specificare il tipo di punto: Hours, Days, Weeks, Months. Questo parametro è uguale all'impostazione seguente nella pagina Impostazioni fasedell'Aggiunta guidata fase nella console: l'installazione è necessaria dopo questo periodo di tempo.

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

-DeploymentOption

Questo parametro è uguale all'impostazione seguente nella pagina Punti di distribuzionedell'Aggiunta guidata fase nella console: selezionare l'opzione di distribuzione da usare quando un client usa un punto di distribuzione da un gruppo di limiti adiacente o dal gruppo di limiti del sito predefinito. Accetta i valori seguenti:

  • DownloadContentLocallyWhenNeededByRunningTaskSequence: scaricare il contenuto in locale quando necessario in base alla sequenza di attività in esecuzione
  • DownloadAllContentLocallyBeforeStartingTaskSequence: scaricare tutto il contenuto in locale prima di avviare la sequenza di attività
Tipo:DeploymentOptionType
Valori accettati:DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence
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

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto. Non è consigliabile. Non è possibile combinarlo con DisableWildcardHandling.

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

-InstallationChoice

Specificare un'opzione per il comportamento relativo a quando il software viene reso disponibile:

  • AsSoonAsPossible: questo parametro è uguale all'impostazione seguente nella pagina Impostazioni fasedell'Aggiunta guidata fase nella console: l'installazione è necessaria il prima possibile.

  • AfterPeriod: questo parametro corrisponde all'impostazione seguente nella pagina Impostazioni fasedell'Aggiunta guidata fase nella console: l'installazione è necessaria dopo questo periodo di tempo. Se si specifica questo valore, usare DeadlineUnit e DeadlineValue per configurare il periodo di tempo.

Tipo:InstallationChoiceType
Valori accettati:AsSoonAsPossible, AfterPeriod
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PhaseName

Specificare un nome per la fase.

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

-PreDownload

Questo parametro è uguale all'impostazione seguente nella pagina Generaledell'Aggiunta guidata fase nella console: Pre-download del contenuto per questa sequenza di attività.

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

-SoftwareInstallation

Questo parametro è uguale all'impostazione seguente nella pagina Esperienza utentedell'Aggiunta guidata fase nella console: Installazione software. Questa impostazione si applica quando viene raggiunta la scadenza dell'installazione, per consentire l'esecuzione di questa attività all'esterno della finestra di manutenzione.

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

-ThrottlingDays

Specificare un valore intero per il numero di giorni per rendere gradualmente disponibile questo software. Questo parametro è lo stesso dell'impostazione seguente nella pagina Impostazioni fasedell'Aggiunta guidata fase nella console: rendere gradualmente disponibile il software in questo periodo di tempo (in giorni).

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

-UserNotification

Questo parametro è uguale all'impostazione seguente nella pagina Esperienza utentedell'Aggiunta guidata fase nella console: Specificare l'impostazione dell'esperienza utente per questa distribuzione con i valori seguenti:

  • DisplayAll: visualizza in Software Center e mostra tutte le notifiche
  • HideAll: nascondi in Software Center e tutte le notifiche
Tipo:UserNotificationType
Valori accettati:DisplayAll, HideAll
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

-WriteFilterCommit

Questo parametro è uguale all'impostazione seguente nella pagina Esperienza utentedell'Aggiunta guidata fase nella console: Eseguire il commit delle modifiche alla scadenza o durante una finestra di manutenzione (è necessario riavviare). Questa impostazione si applica alla gestione dei filtri di scrittura per i dispositivi Windows Embedded.

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

Input

None

Output

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase