New-CMTaskSequencePhase

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.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	BeginConditionType
Accepted values:	AfterPeriod, Manually
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Collection

Specificare un oggetto per la raccolta di destinazione

Type:	IResultObject
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionId

Specificare la raccolta di destinazione in base all'ID.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionName

Specificare la raccolta di destinazione in base al nome.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Comments

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

Type:	String
Position:	Named
Default value:	None
Required:	False
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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 .

Type:	CriteriaType
Accepted values:	Compliance, Number
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CriteriaValue

Questo valore intero dipende dal valore specificato per CriteriaOption:

• Compliance: specificare la percentuale

• Number: specificare il numero di dispositivi

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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).

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

-DeadlineUnit

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

Type:	TimeUnitType
Accepted values:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeadlineValue

Questo parametro viene usato 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.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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à

Type:	DeploymentOptionType
Accepted values:	DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence
Position:	Named
Default value:	None
Required:	False
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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	InstallationChoiceType
Accepted values:	AsSoonAsPossible, AfterPeriod
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PhaseName

Specificare un nome per la fase.

Type:	String
Aliases:	Name
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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à.

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-ThrottlingDays

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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

Type:	UserNotificationType
Accepted values:	DisplayAll, HideAll
Position:	Named
Default value:	None
Required:	False
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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

Input

None

Output

Microsoft.ConfigurationManager.PhasedDeploymentModel.Phase