Set-CMTaskSequencePhase
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 percentualeNumber
: 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 esecuzioneDownloadAllContentLocallyBeforeStartingTaskSequence
: 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 notificheHideAll
: 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
Collegamenti correlati
- Get-CMPhase
- New-CMTaskSequencePhase
- Get-CMTaskSequencePhasedDeployment
- New-CMTaskSequenceAutoPhasedDeployment
- New-CMTaskSequenceManualPhasedDeployment
- Remove-CMTaskSequencePhasedDeployment
- Set-CMTaskSequencePhasedDeployment
- Get-CMPhasedDeploymentStatus
- Move-CMPhasedDeploymentToNext
- Resume-CMPhasedDeployment
- Suspend-CMPhasedDeployment
- Creare distribuzioni in più fasi