New-CMApplicationAutoPhasedDeployment
Verwenden Sie dieses Cmdlet, um eine mehrstufige Bereitstellung für eine Anwendung zu erstellen, indem Sie zwei Phasen mit den gleichen Einstellungen generieren.
Syntax
New-CMApplicationAutoPhasedDeployment
[-Application] <IResultObject>
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMApplicationAutoPhasedDeployment
[-ApplicationId] <String>
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMApplicationAutoPhasedDeployment
[-ApplicationName] <String>
[-BeginCondition <BeginConditionType>]
[-CriteriaOption <CriteriaType>]
[-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>]
[-DeadlineUnit <TimeUnitType>]
[-DeadlineValue <Int32>]
[-FirstCollection <IResultObject>]
[-FirstCollectionId <String>]
[-FirstCollectionName <String>]
[-InstallationChoice <InstallationChoiceType>]
[-SecondCollection <IResultObject>]
[-SecondCollectionId <String>]
[-SecondCollectionName <String>]
[-ThrottlingDays <Int32>]
[-Description <String>]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Verwenden Sie dieses Cmdlet, um eine mehrstufige Bereitstellung für eine Anwendung zu erstellen, indem Sie zwei Phasen mit den gleichen Einstellungen generieren. Das Verhalten dieses Cmdlets ist identisch mit dem Assistenten zum Erstellen einer phasenweisen Bereitstellung für eine Anwendung, wenn Sie die Option Automatisches Erstellen einer zweiphasige Standardbereitstellung auswählen.
Hinweis
Bevor Sie eine mehrstufige Bereitstellung erstellen, stellen Sie sicher, dass Sie den Inhalt der Anwendung an einen Verteilungspunkt verteilen.
Beispiele
Beispiel 1: Erstellen einer Bereitstellung nach App-Name
In diesem Beispiel wird eine stufenweise Anwendungsbereitstellung mit dem Namen myDPName für die Anwendung myApp erstellt.
New-CMApplicationAutoPhasedDeployment -ApplicationName "myApp" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"Beispiel 2: Erstellen einer Bereitstellung durch Eingabe-App-Objekt
In diesem Beispiel wird eine neue anwendungsphasenweise Bereitstellung mit dem Namen myPDName für ein Anwendungsobjekt mit Pipelines erstellt.This example creates a new application phased deployment named myPDName for a piped application object.
$myApp | New-CMApplicationAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"Parameter
-Application
Geben Sie ein Anwendungsobjekt für die stufenweise Bereitstellung an.
| Typ: | IResultObject |
| Position: | 1 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ApplicationId
Geben Sie eine Anwendungs-ID für die stufenweise Bereitstellung an.
| Typ: | String |
| Aliase: | CIId, CI_ID |
| Position: | 1 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ApplicationName
Geben Sie einen Anwendungsnamen für die stufenweise Bereitstellung an.
| Typ: | String |
| Aliase: | ApplicationLocalizedDisplayName |
| Position: | 1 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-BeginCondition
Geben Sie eine Option zum Starten der zweiten Phase der Bereitstellung an, nachdem die erste Phase erfolgreich war:
AfterPeriod: Dieser Parameter ist identisch mit der folgenden Einstellung auf der Seite Einstellungen des Assistenten zum Erstellen von Bereitstellungsphasen in der Konsole: Diese Phase wird nach einer Verzögerungsphase (in Tagen) automatisch gestartet. Wenn Sie diesen Wert angeben, verwenden Sie DaysAfterPreviousPhaseSuccess , um den Zeitraum zu konfigurieren.Manually: Dieser Parameter ist identisch mit der folgenden Einstellung auf der Seite Einstellungen des Assistenten zum Erstellen einer bereitstellung in Phasen in der Konsole: Manuelles Starten der zweiten Phase der Bereitstellung.
| Typ: | BeginConditionType |
| Zulässige Werte: | AfterPeriod, Manually |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CriteriaOption
Geben Sie eine Option an, um die Kriterien für den Erfolg der ersten Phase auszuwählen:
Compliance: Dieser Parameter entspricht der folgenden Einstellung auf der Seite Einstellungen des Assistenten zum Erstellen von bereitstellungsphasen in der Konsole: Prozentsatz des Bereitstellungserfolgs. Geben Sie den Prozentwert mit dem CriteriaValue-Parameter an.Number: Dieser Parameter entspricht der folgenden Einstellung auf der Seite Einstellungen des Assistenten zum Erstellen einer phasenweisen Bereitstellung in der Konsole: Anzahl der erfolgreich bereitgestellten Geräte. Geben Sie die Anzahl der Geräte mit dem Parameter CriteriaValue an .
| Typ: | CriteriaType |
| Zulässige Werte: | Compliance, Number |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CriteriaValue
Dieser ganzzahlige Wert hängt von dem Wert ab, den Sie für CriteriaOption angeben:
Compliance: Geben Sie den Prozentsatz an.Number: Geben Sie die Anzahl der Geräte an.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DaysAfterPreviousPhaseSuccess
Geben Sie einen ganzzahligen Wert für die Anzahl der Tage nach dem Erfolg der ersten Phase an, um die zweite Phase zu beginnen. Dieser Parameter ist identisch mit der folgenden Einstellung auf der Seite Einstellungen des Assistenten zum Erstellen einer phasenweisen Bereitstellung in der Konsole: Diese Phase wird automatisch nach einer Verzögerungsphase (in Tagen) gestartet.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DeadlineUnit
Geben Sie den Typ des Stichtags an. Verwenden Sie diesen Parameter mit DeadlineValue.
| Typ: | TimeUnitType |
| Zulässige Werte: | Hours, Days, Weeks, Months |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DeadlineValue
Dieser Parameter wird nur verwendet, wenn Sie mit dem Parameter InstallationChoice angebenAfterPeriod.
Geben Sie einen ganzzahligen Wert für den Zeitraum für den Stichtag an. Verwenden Sie den Parameter DeadlineUnit , um den Typ des Zeitraums anzugeben: Hours, Days, Weeks, Months. Dieser Parameter entspricht der folgenden Einstellung auf der Seite Einstellungen des Assistenten zum Erstellen von Bereitstellungen in Phasen in der Konsole: Installation ist nach diesem Zeitraum erforderlich.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Description
Geben Sie eine Beschreibung für die phasenweise Bereitstellung der Anwendung an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-FirstCollection
Geben Sie ein Auflistungsobjekt für die erste Phase an.
| Typ: | IResultObject |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-FirstCollectionId
Geben Sie eine Sammlungs-ID für die erste Phase an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-FirstCollectionName
Geben Sie einen Sammlungsnamen für die erste Phase an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen. Dies wird nicht empfohlen. Sie können es nicht mit DisableWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-InstallationChoice
Geben Sie eine Option für das Verhalten relativ zum Zeitpunkt der Bereitstellung der Software an:
AsSoonAsPossible: Dieser Parameter entspricht der folgenden Einstellung auf der Seite Einstellungen des Assistenten zum Erstellen von Bereitstellungen in Phasen in der Konsole: Installation ist so schnell wie möglich erforderlich.AfterPeriod: Dieser Parameter entspricht der folgenden Einstellung auf der Seite Einstellungen des Assistenten zum Erstellen von bereitstellungsphasen in der Konsole: Die Installation ist nach diesem Zeitraum erforderlich. Wenn Sie diesen Wert angeben, verwenden Sie DeadlineUnit und DeadlineValue , um den Zeitraum zu konfigurieren.
| Typ: | InstallationChoiceType |
| Zulässige Werte: | AsSoonAsPossible, AfterPeriod |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Name
Geben Sie einen Namen für die phasenweise Bereitstellung der Anwendung an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SecondCollection
Geben Sie ein Auflistungsobjekt für die zweite Phase an.
| Typ: | IResultObject |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SecondCollectionId
Geben Sie eine Sammlungs-ID für die zweite Phase an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SecondCollectionName
Geben Sie einen Sammlungsnamen für die zweite Phase an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ThrottlingDays
Geben Sie einen ganzzahligen Wert für die Anzahl der Tage an, um diese Software schrittweise verfügbar zu machen. Dieser Parameter ist identisch mit der folgenden Einstellung auf der Seite Einstellungen des Assistenten zum Erstellen von bereitstellungsphasen in der Konsole: Stufenweises Bereitstellen dieser Software über diesen Zeitraum (in Tagen).
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
IResultObject