New-CMApplicationAutoPhasedDeployment

Referenz

Modul:: ConfigurationManager

Verwenden Sie dieses Cmdlet, um eine phasenweise Bereitstellung für eine Anwendung zu erstellen, indem Sie zwei Phasen mit denselben 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 phasenweise Bereitstellung für eine Anwendung zu erstellen, indem Sie zwei Phasen mit denselben Einstellungen generieren. Das Verhalten dieses Cmdlets ist mit dem Assistenten zum Erstellen einer phasenweisen Bereitstellung in einer Anwendung identisch, wenn Sie die Option zum automatischen Erstellen einer standardmäßigen Bereitstellungin zwei Phasen auswählen.

Hinweis

Bevor Sie eine phasenweise Bereitstellung erstellen, stellen Sie sicher, dass Sie den Inhalt der Anwendung an einen Verteilungspunkt verteilen.

Beispiele

Beispiel 1: Erstellen einer Bereitstellung anhand des App-Namens

In diesem Beispiel wird eine neue Anwendungsphasenbereitstellung namens "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 nach Eingabe-App-Objekt

In diesem Beispiel wird eine neue Anwendungsphasenbereitstellung namens "myPDName" für ein weitergeleitetes Anwendungsobjekt erstellt.

$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 phasenweise Bereitstellung an.

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

-ApplicationId

Geben Sie eine Anwendungs-ID für die phasenweise Bereitstellung an.

Type:	String
Aliases:	CIId, CI_ID
Position:	1
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ApplicationName

Geben Sie einen Anwendungsnamen für die phasenweise Bereitstellung an.

Type:	String
Aliases:	ApplicationLocalizedDisplayName
Position:	1
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-BeginCondition

Geben Sie eine Option für den Beginn der zweiten Bereitstellungsphase nach erfolg der ersten Phase an:

AfterPeriod: Dieser Parameter entspricht der folgenden Einstellung auf der Einstellungen Seite des Assistenten zum Erstellen einer phasenweisen Bereitstellung in der Konsole: Beginnt diese Phase automatisch nach einem Verzögerungszeitraum (in Tagen). Wenn Sie diesen Wert angeben, verwenden Sie DaysAfterPreviousPhaseSuccess, um den Zeitraum zu konfigurieren.
Manually: Dieser Parameter entspricht der folgenden Einstellung auf der Einstellungen Seite des Assistenten zum Erstellen einer phasenweisen Bereitstellung in der Konsole: Beginnen Sie manuell mit der Bereitstellung der zweiten Phase.

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

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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

-CriteriaOption

Geben Sie eine Option zum Auswählen der Kriterien für den Erfolg der ersten Phase an:

Compliance: Dieser Parameter entspricht der folgenden Einstellung auf der Einstellungen Seite des Assistenten zum Erstellen einer phasenweisen Bereitstellung in der Konsole: Prozentsatz des Bereitstellungserfolgs. Geben Sie den Prozentwert mit dem Parameter CriteriaValue an.
Number: Dieser Parameter entspricht der folgenden Einstellung auf der Einstellungen Seite 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.

Type:	CriteriaType
Accepted values:	Compliance, Number
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CriteriaValue

Dieser ganzzahlige Wert hängt vom Wert ab, den Sie für CriteriaOptionangeben:

Compliance: Angeben des Prozentsatzes
Number: Angeben der Anzahl von Geräten

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

-DaysAfterPreviousPhaseSuccess

Geben Sie einen ganzzahligen Wert für die Anzahl der Tage nach dem Erfolg der ersten Phase an, um mit der zweiten Phase zu beginnen. Dieser Parameter entspricht der folgenden Einstellung auf der Einstellungen Seite des Assistenten zum Erstellen einer phasenweisen Bereitstellung in der Konsole: Beginnt diese Phase automatisch nach einem Verzögerungszeitraum (in Tagen).

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

-DeadlineUnit

Geben Sie den Typ des Stichtagszeitraums an. Verwenden Sie diesen Parameter mit DeadlineValue.

Type:	TimeUnitType
Accepted values:	Hours, Days, Weeks, Months
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeadlineValue

Dieser Parameter wird nur verwendet, wenn Sie AfterPeriod dies mit dem Parameter "InstallationChoice" angeben.

Geben Sie einen ganzzahligen Wert für den Zeitraum für den Stichtag an. Verwenden Sie den DeadlineUnit -Parameter, um den Typ des Zeitraums anzugeben: Hours , , , Days Weeks Months . Dieser Parameter entspricht der folgenden Einstellung auf der Einstellungen Seite des Assistenten zum Erstellen einer phasenweisen Bereitstellung in der Konsole: Die Installation ist nach diesem Zeitraum erforderlich.

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

-Description

Geben Sie eine Beschreibung für die phasenweise Bereitstellung der Anwendung an.

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

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

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

-FirstCollection

Geben Sie ein Auflistungsobjekt für die erste Phase an.

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

-FirstCollectionId

Geben Sie eine Sammlungs-ID für die erste Phase an.

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

-FirstCollectionName

Geben Sie einen Sammlungsnamen für die erste Phase an.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen. Dies wird nicht empfohlen. Sie können es nicht mit DisableWildcardHandlingkombinieren.

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

-InstallationChoice

Geben Sie eine Option für das Verhalten relativ zu dem Zeitpunkt an, zu dem die Software verfügbar gemacht wird:

AsSoonAsPossible: Dieser Parameter entspricht der folgenden Einstellung auf der Einstellungen Seite des Assistenten zum Erstellen einer phasenweisen Bereitstellung in der Konsole: Die Installation ist so schnell wie möglich erforderlich.
AfterPeriod: Dieser Parameter entspricht der folgenden Einstellung auf der Einstellungen Seite des Assistenten zum Erstellen einer phasenweisen Bereitstellung 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.

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

-Name

Geben Sie einen Namen für die phasenweise Bereitstellung der Anwendung an.

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

-SecondCollection

Geben Sie ein Auflistungsobjekt für die zweite Phase an.

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

-SecondCollectionId

Geben Sie eine Sammlungs-ID für die zweite Phase an.

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

-SecondCollectionName

Geben Sie einen Sammlungsnamen für die zweite Phase an.

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

-ThrottlingDays

Geben Sie einen ganzzahligen Wert für die Anzahl der Tage an, um diese Software schrittweise verfügbar zu machen. Dieser Parameter entspricht der folgenden Einstellung auf der Einstellungen Seite des Assistenten zum Erstellen einer phasenweisen Bereitstellung in der Konsole: Stellen Sie diese Software schrittweise über diesen Zeitraum (in Tagen) zur Verfügung.

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

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

IResultObject