Set-CMApplicationDeployment
Konfigurieren einer Anwendungsbereitstellung
Syntax
Set-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
[-AutoCloseExecutable <Boolean>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-CreateAlertBaseOnPercentFailure <Boolean>]
[-CreateAlertBaseOnPercentSuccess <Boolean>]
[-DeadlineDateTime <DateTime>]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
-InputObject <IResultObject>
[-OverrideServiceWindow <Boolean>]
[-PersistOnWriteFilterDevice <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RaiseMomAlertsOnFailure <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-RequireApproval <Boolean>]
[-SendWakeUpPacket <Boolean>]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UseMeteredNetwork <Boolean>]
[-UserNotification <UserNotificationType>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
-ApplicationId <String>
[-AutoCloseExecutable <Boolean>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-CreateAlertBaseOnPercentFailure <Boolean>]
[-CreateAlertBaseOnPercentSuccess <Boolean>]
[-DeadlineDateTime <DateTime>]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
[-OverrideServiceWindow <Boolean>]
[-PersistOnWriteFilterDevice <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RaiseMomAlertsOnFailure <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-RequireApproval <Boolean>]
[-SendWakeUpPacket <Boolean>]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UseMeteredNetwork <Boolean>]
[-UserNotification <UserNotificationType>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
-ApplicationName <String>
[-AutoCloseExecutable <Boolean>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-CreateAlertBaseOnPercentFailure <Boolean>]
[-CreateAlertBaseOnPercentSuccess <Boolean>]
[-DeadlineDateTime <DateTime>]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
[-OverrideServiceWindow <Boolean>]
[-PersistOnWriteFilterDevice <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RaiseMomAlertsOnFailure <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-RequireApproval <Boolean>]
[-SendWakeUpPacket <Boolean>]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UseMeteredNetwork <Boolean>]
[-UserNotification <UserNotificationType>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Das Cmdlet Set-CMApplicationDeployment ändert die Eigenschaften einer Anwendungsbereitstellung in Configuration Manager. Weitere Informationen finden Sie unter Bereitstellen von Anwendungen mit Configuration Manager.
Um eine zu ändernde Anwendungsbereitstellung anzugeben, geben Sie den Sammlungsnamen und die Anwendung an. Sie können eine Anwendung anhand des Namens oder der ID angeben. Sie können auch das Cmdlet Get-CMApplication verwenden, um eine zu ändernde Anwendung abzurufen.
Hinweis
Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 1: Ändern der Verfügbarkeit und des Stichtags für eine Anwendungsbereitstellung
Set-CMApplicationDeployment -ApplicationName "Track System 2011" -CollectionName "All Users" -AvailableDateTime (Get-Date) -DeadlineDateTime $(Get-Date).AddDays(30)Dieser Befehl ändert eine Anwendungsbereitstellung für eine Anwendung namens Track System 2011 für eine Sammlung mit dem Namen Alle Benutzer. Der Befehl gibt das aktuelle Datum für die Verfügbarkeit der Anwendung an. Außerdem wird der Bereitstellungsstichtag für 30 Tage in der Zukunft konfiguriert.
Parameter
-AllowRepairApp
Verwenden Sie diesen Parameter, um die Option "Anwendung reparieren" beim Erstellen einer Bereitstellung für eine Anwendung zu konfigurieren.
| Typ: | Boolean |
| Aliase: | AllowUserRepairApplication |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ApplicationId
Gibt die ID einer Anwendung an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ApplicationName
Gibt den Namen einer Anwendung an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AutoCloseExecutable
Legen Sie ab Version 2107 diesen Parameter auf fest $true , um die Anwendungsbereitstellungseinstellung für Installationsverhalten zu aktivieren. Verwenden Sie dann das Cmdlet Add-CMDeploymentTypeInstallBehavior , um eine ausführbare Datei hinzuzufügen, um zu überprüfen, ob die Installation nicht ausgeführt wird.
Legen Sie diesen Parameter auf fest $false , um diese Option in den folgenden Situationen zu deaktivieren:
- Wenn Sie das Cmdlet Remove-CMDeploymentTypeInstallBehavior verwenden, um alle ausführbaren Dateien zu entfernen
- Sie möchten nicht, dass die Bereitstellung überprüft, ob ausführbare Dateien ausgeführt werden.
| Typ: | Boolean |
| Aliase: | AutoCloseExeOnInstallBehavior |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-AvailableDateTime
Geben Sie ein DateTime-Objekt für den Zeitpunkt an, an dem diese Bereitstellung verfügbar ist. Verwenden Sie zum Abrufen dieses Objekts das integrierte Cmdlet Get-Date .
Verwenden Sie DeadlineDateTime , um die Bereitstellungszuweisung oder den Stichtag anzugeben.
| Typ: | DateTime |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Collection
Geben Sie ein Auflistungsobjekt an, für das die Anwendung bereitgestellt wird. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMCollection .
| Typ: | IResultObject |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CollectionId
Geben Sie die ID der Sammlung an, in der die Anwendung bereitgestellt wird. Beispiel: "SMS00004".
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CollectionName
Geben Sie den Namen der Sammlung an, in der die Anwendung bereitgestellt wird.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | True |
-Comment
Gibt einen optionalen Kommentar für die Bereitstellung an.
| Typ: | String |
| 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: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CreateAlertBaseOnPercentFailure
Gibt an, ob eine Warnung für einen Prozentsatz der Anwendungen erstellt werden soll, die nicht bereitgestellt werden können. Verwenden Sie den Parameter FailParameterValue , um den Prozentwert anzugeben.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-CreateAlertBaseOnPercentSuccess
Gibt an, ob eine Warnung für einen Prozentsatz der Anwendungen erstellt werden soll, die erfolgreich bereitgestellt werden. Verwenden Sie den SuccessParameterValue-Parameter , um den Prozentwert anzugeben.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-DeadlineDateTime
Geben Sie für die Bereitstellung ein DateTime-Objekt an, das auch als Stichtag bezeichnet wird. Verwenden Sie zum Abrufen dieses Objekts das integrierte Cmdlet Get-Date .
Verwenden Sie -AvailableDateTime , um anzugeben, wann die Bereitstellung verfügbar ist.
| Typ: | DateTime |
| 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 |
-EnableMomAlert
Legen Sie diesen Parameter auf fest $true , um den System Center Operations Manager-Wartungsmodus für diese Bereitstellung zu aktivieren.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-EnableSoftDeadline
Legen Sie diesen Parameter auf fest $true , um die verzögerte Erzwingung zu aktivieren.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-FailParameterValue
Gibt den Prozentsatz der fehlerhaften Anwendungsinstallation an, die eine Warnung verursacht.
Geben Sie eine ganze Zahl zwischen 1 und 100 an.
Legen Sie zum Aktivieren dieser Warnung den Parameter CreatAlertBaseOnPercentFailure auf fest $True.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-InputObject
Geben Sie ein zu konfigurierende Anwendungsbereitstellungsobjekt an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMApplicationDeployment .
| Typ: | IResultObject |
| Aliase: | Application, DeploymentSummary, Assignment |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-OverrideServiceWindow
Gibt an, ob die Bereitstellung auch dann erfolgt, wenn sie außerhalb eines Wartungsfensters geplant ist.
Ein Wartungsfenster ist ein festgelegter Zeitraum, der für die Computerwartung und -updates verwendet wird.
Wenn dieser Wert ist $True, stellt Configuration Manager die Anwendung auch dann bereit, wenn die geplante Zeit außerhalb des Wartungsfensters liegt.
Wenn dieser Wert ist $False, stellt Configuration Manager die Anwendung nicht außerhalb des Fensters bereit. Sie wartet, bis sie in einem verfügbaren Fenster bereitgestellt werden kann.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PassThru
Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PersistOnWriteFilterDevice
Gibt an, ob Schreibfilter für eingebettete Geräte aktiviert werden sollen.
Für den Wert committet $Truedas Gerät Änderungen während eines Wartungsfensters. Diese Aktion erfordert einen Neustart.
Für den Wert $Falsespeichert das Gerät Änderungen in einer Überlagerung und committet sie später.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PostponeDateTime
Wenn Sie CreateAlertBaseOnPercentSuccess auf $truefestlegen, verwenden Sie diesen Parameter, um ein DateTime-Objekt anzugeben. Configuration Manager erstellt eine Bereitstellungswarnung, wenn der Schwellenwert nach diesem Datum niedriger als der SuccessParameterValue-Wert ist.
Verwenden Sie zum Abrufen dieses Objekts das integrierte Cmdlet Get-Date .
| Typ: | DateTime |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-PreDeploy
Gibt an, ob die Anwendung vorab auf dem primären Gerät des Benutzers bereitgestellt werden soll.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RaiseMomAlertsOnFailure
Gibt an, ob eine Operations Manager-Warnung erstellt werden soll, wenn ein Client die Anwendung nicht installieren kann.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RebootOutsideServiceWindow
Gibt an, ob ein Computer außerhalb eines Wartungsfensters neu gestartet wird.
Ein Wartungsfenster ist ein festgelegter Zeitraum, der für die Computerwartung und -updates verwendet wird.
Wenn dieser Wert ist $True, erfolgt jeder erforderliche Neustart ohne Berücksichtigung von Wartungsfenstern.
Wenn dieser Wert ist $False, wird der Computer nicht außerhalb eines Wartungsfensters neu gestartet.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ReplaceToastNotificationWithDialog
Wenn die erforderliche Software auf dem Client verfügbar ist, legen Sie diesen Parameter auf $true fest, um die standardmäßigen Popupbenachrichtigungen durch ein Dialogfeld zu ersetzen. Dies ist standardmäßig false. Weitere Informationen finden Sie unter Ersetzen von Popupbenachrichtigungen durch Dialogfeld.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RequireApproval
Wenn Sie diesen Parameter auf $truefestlegen, muss ein Administrator eine Anforderung für diese Anwendung auf dem Gerät genehmigen.
| Typ: | Boolean |
| Aliase: | AppRequiresApproval |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SendWakeUpPacket
Gibt an, ob vor Beginn der Bereitstellung ein Aktivierungspaket an Computer gesendet werden soll.
Wenn dieser Wert ist $True, versucht Configuration Manager, einen Computer aus dem Ruhezustand zu reaktivieren.
Wenn dieser Wert ist $False, werden Computer nicht aus dem Ruhezustand reaktiviert.
Damit Computer reaktivieren können, müssen Sie zuerst Wake-On-LAN konfigurieren.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SuccessParameterValue
Gibt den Prozentsatz der erfolgreichen Anwendungsinstallation an, die eine Warnung auslöst.
Geben Sie eine ganze Zahl zwischen 0 und 99 an.
Um diese Warnung zu aktivieren, legen Sie den Parameter CreateAlertBaseOnPercentSuccess auf fest $True.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-TimeBaseOn
Gibt an, welche Zeitzone verwendet werden soll:
-
LocalTime: Lokale Zeit verwenden. -
UTC: Verwenden Sie koordinierte Weltzeit (UTC).
| Typ: | TimeType |
| Zulässige Werte: | LocalTime, Utc |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UseMeteredNetwork
Gibt an, ob Clients das Herunterladen von Inhalten über eine getaktete Internetverbindung nach Ablauf des Stichtags ermöglichen sollen, was zusätzliche Kosten verursachen kann.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UserNotification
Gibt den Typ der Benutzerbenachrichtigung an.
-
DisplayAll: Anzeigen im Softwarecenter und Anzeigen aller Benachrichtigungen. -
DisplaySoftwareCenterOnly: Wird im Softwarecenter angezeigt, und zeigt nur Benachrichtigungen über Computerneustarts an. -
HideAll: Im Softwarecenter und alle Benachrichtigungen ausblenden.
| Typ: | UserNotificationType |
| Zulässige Werte: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
| 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: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
IResultObject
Hinweise
Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_ApplicationAssignment WMI-Serverklasse.