Set-CMTaskSequencePhase

Riferimento

Modulo:: ConfigurationManager

Usare 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. Usare questo cmdlet per configurare una fase di distribuzione per una sequenza di attività. Per altre informazioni, vedere Creare distribuzioni in più fasi.

Esempio

Esempio 1: Modificare la raccolta

In questo esempio viene modificata la raccolta per la seconda fase della distribuzione in più 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. 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 della fase

In questo esempio vengono modificate 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 è 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:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CollectionId

Specificare la raccolta di destinazione in base all'ID.

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

-CollectionName

Specificare la raccolta di destinazione in base al nome.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
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

-Id

Specificare l'ID della fase da configurare.

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

-InputObject

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

Tipo:	IResultObject
Alias:	PhasedDeployment
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
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

-MovePhase

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

Tipo:	ReorderType
Valori accettati:	MoveUp, MoveDown, MoveToOrder
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-MoveToOrder

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

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

-Name

Specificare il nome della fase da configurare.

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

-NewCollection

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

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

-NewCollectionId

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

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

-NewCollectionName

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

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

-NewPhaseName

Usare questo parametro per rinominare la fase selezionata.

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

-Order

Specificare l'indice della fase da configurare.

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

-PhasedDeploymentId

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

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

-PhasedDeploymentName

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

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

IResultObject

Condividi tramite