New-CMTaskSequenceAutoPhasedDeployment
Usare questo cmdlet per creare una distribuzione in più fasi per una sequenza di attività generando due fasi con le stesse impostazioni.
Sintassi
New-CMTaskSequenceAutoPhasedDeployment
[-TaskSequence] <IResultObject>
[-AddPhases <Phase[]>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InsertAtOrder <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMTaskSequenceAutoPhasedDeployment
[-TaskSequenceId] <String>
[-AddPhases <Phase[]>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InsertAtOrder <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMTaskSequenceAutoPhasedDeployment
[-TaskSequenceName] <String>
[-AddPhases <Phase[]>]
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InsertAtOrder <Int32>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Descrizione
Usare questo cmdlet per creare una distribuzione in più fasi per una sequenza di attività generando due fasi con le stesse impostazioni. Il comportamento di questo cmdlet è lo stesso della procedura guidata Crea distribuzione in più fasi in una sequenza di attività quando si seleziona l'opzione Crea automaticamente una distribuzione a due fasi predefinita.
Nota
Prima di creare una distribuzione in più fasi, assicurarsi di distribuire il contenuto della sequenza di attività in un punto di distribuzione.
Esempio
Esempio 1: Creare una distribuzione in base al nome della sequenza di attività
In questo esempio viene creata una nuova distribuzione in più fasi della sequenza di attività denominata myDPName per la sequenza di attività myTaskSequenceName.
New-CMTaskSequenceAutoPhasedDeployment -TaskSequenceName "myTaskSequenceName" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"Esempio 2: Creare una distribuzione tramite l'oggetto sequenza di attività di input
In questo esempio viene creata una nuova distribuzione in più fasi della sequenza di attività denominata myPDName per un oggetto sequenza di attività con pipe.
$myTS | New-CMTaskSequenceAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"Parametri
-AddPhases
Questo cmdlet crea automaticamente due fasi per le due raccolte specificate. È anche possibile aggiungere altre fasi con questo parametro. Specificare una matrice di fasi. Usare New-CMTaskSequencePhase per creare le fasi.
| Tipo: | Phase[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-BeginCondition
Specificare un'opzione per iniziare la seconda fase di distribuzione dopo l'esito positivo della prima fase:
AfterPeriod: questo parametro è uguale all'impostazione seguente nella pagina Impostazioni della creazione guidata distribuzione in più fasi 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 della creazione guidata distribuzione in più fasi nella console: Iniziare manualmente la distribuzione della seconda fase.
| Tipo: | BeginConditionType |
| Valori accettati: | AfterPeriod, Manually |
| 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 prima fase:
Compliance: questo parametro è uguale all'impostazione seguente nella pagina Impostazioni della creazione guidata distribuzione in più fasi 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 della creazione guidata distribuzione in più fasi 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 percentualeNumber: 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 dopo l'esito positivo della prima fase per iniziare la seconda fase. Questo parametro è lo stesso dell'impostazione seguente nella pagina Impostazioni della creazione guidata distribuzione in più fasi 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 della Creazione guidata distribuzione in più fasi 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 |
-Description
Specificare una descrizione per la distribuzione in più fasi della sequenza di attività.
| Tipo: | String |
| 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 |
-FirstCollection
Specificare un oggetto raccolta per la prima fase.
| Tipo: | IResultObject |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-FirstCollectionId
Specificare un ID raccolta per la prima fase.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-FirstCollectionName
Specificare un nome di raccolta per la prima fase.
| Tipo: | String |
| 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 |
-InsertAtOrder
Se si usa il parametro AddPhases , usare questo parametro per determinare dove, nell'ordine delle fasi, inserire le fasi aggiuntive. Specificare un numero intero con il numero di ordine.
| Tipo: | Int32 |
| 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 della Creazione guidata distribuzione in più fasi nella console: l'installazione è necessaria il prima possibile.AfterPeriod: questo parametro è lo stesso dell'impostazione seguente nella pagina Impostazioni della Creazione guidata distribuzione in più fasi 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 |
-Name
Specificare un nome per la distribuzione in più fasi della sequenza di attività.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-SecondCollection
Specificare un oggetto raccolta per la seconda fase.
| Tipo: | IResultObject |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-SecondCollectionId
Specificare un ID raccolta per la seconda fase.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-SecondCollectionName
Specificare un nome di raccolta per la seconda fase.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-TaskSequence
Specificare un oggetto sequenza di attività.
| Tipo: | IResultObject |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-TaskSequenceId
Specificare una sequenza di attività in base all'ID.
| Tipo: | String |
| Alias: | TaskSequencePackageId |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-TaskSequenceName
Specificare una sequenza di attività in base al nome.
| Tipo: | String |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | True |
| 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 è uguale all'impostazione seguente nella pagina Impostazioni della creazione guidata distribuzione in più fasi 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 |
-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 |
Input
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Output
IResultObject