Set-CMTaskSequencePhase

Riferimento

Modulo:: ConfigurationManager

Utilizzare questo cmdlet per configurare una fase di distribuzione per una sequenza di attività.

Sintassi

Set-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-Comments <String>]
   [-DeploymentOption <DeploymentOptionType>]
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-MovePhase <ReorderType>]
   [-MoveToOrder <Int32>]
   [-NewCollection <IResultObject>]
   [-NewCollectionId <String>]
   [-NewCollectionName <String>]
   [-NewPhaseName <String>]
   [-ThrottlingDays <Int32>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-Id <String>]
   [-InputObject] <IResultObject>
   [-Name <String>]
   [-Order <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-Comments <String>]
   [-DeploymentOption <DeploymentOptionType>]
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-MovePhase <ReorderType>]
   [-MoveToOrder <Int32>]
   [-NewCollection <IResultObject>]
   [-NewCollectionId <String>]
   [-NewCollectionName <String>]
   [-NewPhaseName <String>]
   [-ThrottlingDays <Int32>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-Id <String>]
   [-Name <String>]
   [-Order <Int32>]
   [-PhasedDeploymentId] <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequencePhase
   [-AllowFallback <Boolean>]
   [-AllowRemoteDP <Boolean>]
   [-AllowSystemRestart <Boolean>]
   [-Comments <String>]
   [-DeploymentOption <DeploymentOptionType>]
   [-PreDownload <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-WriteFilterCommit <Boolean>]
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-InstallationChoice <InstallationChoiceType>]
   [-MovePhase <ReorderType>]
   [-MoveToOrder <Int32>]
   [-NewCollection <IResultObject>]
   [-NewCollectionId <String>]
   [-NewCollectionName <String>]
   [-NewPhaseName <String>]
   [-ThrottlingDays <Int32>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-Id <String>]
   [-Name <String>]
   [-Order <Int32>]
   [-PhasedDeploymentName] <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Si applica alla versione 2006 e successive. Utilizzare questo cmdlet per configurare una fase di distribuzione per una sequenza di attività. Per ulteriori informazioni, vedere Create phased deployments.

Esempio

Esempio 1: Modificare la raccolta

In questo esempio viene modificata la raccolta per la seconda fase della distribuzione in fasi della sequenza di attività passata nella riga di comando.

$phasedDeployment = Get-CMTaskSequencePhasedDeployment -Name "myPhasedDeployment"

$phasedDeployment | Set-CMTaskSequencePhase -Order 2 -NewCollectionId "XYZ00227"

Esempio 2: Spostare una fase verso l'alto

In questo esempio viene spostata una fase verso l'alto nell'ordine indicato. Seleziona la distribuzione in più fasi in base al relativo ID e seleziona la fase in base all'ID raccolta associato.

Set-CMTaskSequencePhase -PhasedDeploymentId "0bc464d9-e7dd-44c1-a157-3f8be6a79c03" -CollectionId "XYZ00227" -MovePhase MoveUp

Esempio 3: Configurare le impostazioni di fase

In questo esempio vengono cambiate le impostazioni di configurazione per la fase selezionata.

Set-CMTaskSequencePhase -PhasedDeploymentName "myPhasedDeployment" -Name "phase1" -UserNotification HideAll -SoftwareInstallation $true -AllowSystemRestart $true -WriteFilterCommit $false -PreDownload $true -Comments "phase 1 comment" -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowRemoteDP $true -AllowFallback $false -CriteriaOption Compliance -CriteriaValue 90 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 3 -ThrottlingDays 5 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 12

Parametri

-AllowFallback

Questo parametro corrisponde all'impostazione seguente **** nella pagina **** Punti di distribuzione dell'Aggiunta guidata fase nella console: Consenti ai client di utilizzare i punti di distribuzione del gruppo di limiti del sito predefinito.

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

-AllowRemoteDP

Questo parametro corrisponde all'impostazione seguente **** nella pagina **** Punti di distribuzione dell'Aggiunta guidata fase nella console: quando non è disponibile alcun punto di distribuzione locale, utilizzare un punto di distribuzione remoto.

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

-AllowSystemRestart

Questo parametro corrisponde all'impostazione seguente **** nella pagina Esperienza utente dell'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à al di fuori della finestra di manutenzione.

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

-BeginCondition

Specificare un'opzione per iniziare questa fase di distribuzione dopo il successo della fase precedente:

AfterPeriod: questo parametro corrisponde all'impostazione seguente nella pagina Fase **** Impostazioni dell'Aggiunta guidata fase nella console: avvia automaticamente questa fase dopo un periodo di differimento (in giorni). Se si specifica questo valore, utilizzare DaysAfterPreviousPhaseSuccess per configurare il periodo di tempo.
Manually: questo parametro corrisponde all'impostazione seguente nella pagina Fase **** Impostazioni dell'Aggiunta guidata fase nella console: Iniziare manualmente questa fase di distribuzione.

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

-Collection

Specificare un oggetto per l'insieme di destinazione

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

-CollectionId

Specifica la raccolta di destinazione in base all'ID.

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

-CollectionName

Specificare la raccolta di destinazione in base al nome.

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

-Comments

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

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

-CriteriaOption

Specificare un'opzione per scegliere i criteri per il successo della fase precedente:

Compliance: questo parametro corrisponde all'impostazione seguente nella pagina Fase **** Impostazioni dell'Aggiunta guidata fase nella console: Percentuale di successo della distribuzione. Specificare il valore percentuale con il parametro CriteriaValue.
Number: questo parametro corrisponde all'impostazione seguente nella pagina Fase **** Impostazioni dell'Aggiunta guidata fase nella console: Numero di dispositivi distribuiti correttamente. Specifica il numero di dispositivi con il parametro CriteriaValue.

Type:	CriteriaType
Accepted values:	Compliance, Number
Position:	Named
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	False

-DaysAfterPreviousPhaseSuccess

Specificare un valore intero per il numero di giorni dopo l'esito positivo della fase precedente per iniziare questa fase. Questo parametro corrisponde all'impostazione seguente nella pagina Phase Impostazioni dell'Aggiunta guidata fase nella console: avvia automaticamente questa fase dopo un periodo di differimento (in giorni). ****

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

-DeadlineUnit

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

Type:	TimeUnitType
Accepted values:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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 periodo: Hours , , , Days Weeks Months . Questo parametro corrisponde all'impostazione seguente nella pagina Fase **** Impostazioni dell'Aggiunta guidata fase nella console: l'installazione è necessaria dopo questo periodo di tempo.

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

-DeploymentOption

Questo parametro corrisponde all'impostazione seguente **** nella pagina **** Punti di distribuzione dell'Aggiunta guidata fase nella console: selezionare l'opzione di distribuzione da utilizzare quando un client utilizza un punto di distribuzione da un gruppo di limiti adiacenti o dal gruppo di limiti del sito predefinito. Accetta i valori seguenti:

DownloadContentLocallyWhenNeededByRunningTaskSequence: scaricare il contenuto in locale quando necessario per la 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
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

-ForceWildcardHandling

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

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

-Id

Specificare l'ID della fase da configurare.

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

-InputObject

Specificare un oggetto distribuzione in più fasi che includa la fase da configurare.

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

-InstallationChoice

Specificare un'opzione per il comportamento relativo alla disponibilità del software:

AsSoonAsPossible: questo parametro corrisponde all'impostazione seguente nella pagina Fase **** Impostazioni dell'Aggiunta guidata fase nella console: l'installazione è necessaria il prima possibile.
AfterPeriod: questo parametro corrisponde all'impostazione seguente nella pagina Fase **** Impostazioni dell'Aggiunta guidata fase nella console: l'installazione è necessaria dopo questo periodo di tempo. Se si specifica questo valore, utilizzare DeadlineUnit e DeadlineValue per configurare il periodo di tempo.

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

-MovePhase

Modificare l'ordine della fase selezionata. È possibile spostarlo verso l'alto di uno, spostarlo verso il basso di uno o passare a un indice specifico. Se si specifica MoveToOrder , utilizzare il parametro -MoveToOrder per impostare l'indice specifico.

Type:	ReorderType
Accepted values:	MoveUp, MoveDown, MoveToOrder
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MoveToOrder

Quando si imposta il parametro -MovePhase su MoveToOrder , utilizzare questo parametro per impostare l'indice specifico.

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

-Name

Specificare il nome della fase da configurare.

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

-NewCollection

Specificare un oggetto insieme da utilizzare come nuova destinazione per la fase selezionata.

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

-NewCollectionId

Specificare una raccolta in base all'ID da utilizzare come nuova destinazione per la fase selezionata.

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

-NewCollectionName

Specificare una raccolta in base al nome da utilizzare come nuova destinazione per la fase selezionata.

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

-NewPhaseName

Utilizzare questo parametro per rinominare la fase selezionata.

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

-Order

Specificare l'indice della fase da configurare.

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

-PhasedDeploymentId

Selezionare la distribuzione in più fasi in base all'ID. Utilizzare quindi altri parametri per selezionare la fase specifica della distribuzione.

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

-PhasedDeploymentName

Selezionare la distribuzione in più fasi in base al nome. Utilizzare quindi altri parametri per selezionare la fase specifica della distribuzione.

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

-PreDownload

Questo parametro corrisponde all'impostazione seguente **** nella pagina Generale dell'Aggiunta guidata fase nella console: Pre-download delcontenuto per questa sequenza di attività.

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

-SoftwareInstallation

Questo parametro corrisponde all'impostazione seguente nella pagina Esperienza utente dell'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à al di fuori della finestra di manutenzione.

Type:	Boolean
Position:	Named
Default value:	None
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 corrisponde all'impostazione seguente nella pagina Phase Impostazioni dell'Aggiunta guidata fase nella console: Rendere gradualmente disponibile questo software in questo periodo di tempo **** (in giorni).

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

-UserNotification

Questo parametro corrisponde all'impostazione seguente **** nella pagina Esperienza utente dell'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
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

-WriteFilterCommit

Questo parametro corrisponde all'impostazione seguente **** nella pagina **** Esperienza utente dell'Aggiunta guidata fase nella console: Confermare le modifiche alla scadenza o durante una finestra di manutenzione (richiede il riavvio). Questa impostazione si applica alla gestione dei filtri di scrittura per Windows dispositivi incorporati.

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

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

IResultObject