New-CMApplicationDeployment

Modul:

ConfigurationManager

Erstellen Sie eine Anwendungsbereitstellung.

Syntax

New-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-ApprovalRequired <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-DisableContentDependencyDetection]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-InputObject] <IResultObject>
   [-OverrideServiceWindow <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-Simulation]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UpdateSupersedence <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-ApprovalRequired <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-DisableContentDependencyDetection]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-Id] <Int32>
   [-OverrideServiceWindow <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-Simulation]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UpdateSupersedence <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMApplicationDeployment
   [-AllowRepairApp <Boolean>]
   [-ApprovalRequired <Boolean>]
   [-AutoCloseExecutable <Boolean>]
   [-DeadlineDateTime <DateTime>]
   [-DeployAction <DeployActionType>]
   [-DeployPurpose <DeployPurposeType>]
   [-DisableContentDependencyDetection]
   [-EnableMomAlert <Boolean>]
   [-EnableSoftDeadline <Boolean>]
   [-FailParameterValue <Int32>]
   [-GenerateScomAlertOnFailure <Boolean>]
   [-Name] <String>
   [-OverrideServiceWindow <Boolean>]
   [-PostponeDateTime <DateTime>]
   [-PreDeploy <Boolean>]
   [-RebootOutsideServiceWindow <Boolean>]
   [-ReplaceToastNotificationWithDialog <Boolean>]
   [-Simulation]
   [-SuccessParameterValue <Int32>]
   [-TimeBaseOn <TimeType>]
   [-UpdateSupersedence <Boolean>]
   [-UserNotification <UserNotificationType>]
   [-DistributeCollectionName <String>]
   [-DistributeContent]
   [-DistributionPointGroupName <String>]
   [-DistributionPointName <String>]
   [-AvailableDateTime <DateTime>]
   [-Comment <String>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-SendWakeupPacket <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet "New-CMApplicationDeployment" erstellt eine Anwendungsbereitstellung. Weitere Informationen finden Sie unter Bereitstellen von Anwendungen mit Configuration Manager.

Hinweis

Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".

Beispiele

Beispiel 1: Installieren einer Anwendung

Mit diesem Befehl wird eine neue Bereitstellung für Visual Studio 2019 für die Sammlung Developers Workstationerstellt. Sie installiert die App und ist erforderlich. Sowohl das verfügbare Datum als auch der Stichtag sind der gleiche Zeitpunkt in der Vergangenheit. Sobald der Client diese Richtlinie erhält, wird die App installiert.

New-CMApplicationDeployment -Name "Visual Studio 2019" -AvailableDateTime '01/01/2020 00:00:00' -CollectionName 'Developers Workstation' -DeadlineDateTime '01/01/2020 00:00:00' -DeployAction Install -DeployPurpose Required

Parameter

-AllowRepairApp

Verwenden Sie diesen Parameter, um die Reparaturanwendungsoption beim Erstellen einer Bereitstellung für eine Anwendung zu konfigurieren.

Type:	Boolean
Aliases:	AllowUserRepairApplication
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ApprovalRequired

Wenn Sie diesen Parameter $true festlegen, muss ein Administrator eine Anforderung für diese Anwendung auf dem Gerät genehmigen.

Type:	Boolean
Aliases:	AppRequiresApproval
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AutoCloseExecutable

Legen Sie diesen Parameter ab Version 2107 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 erfolgreich ausgeführt wird.

Legen Sie diesen Parameter $false fest, 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.

Type:	Boolean
Aliases:	AutoCloseExeOnInstallBehavior
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AvailableDateTime

Geben Sie ein DateTime -Objekt an, wenn 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.

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

-Collection

Geben Sie ein Auflistungsobjekt an, für das die Anwendung bereitgestellt wird. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet "Get-CMCollection".

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

-CollectionId

Geben Sie die ID der Auflistung an, für die diese Anwendung bereitgestellt wird. Beispiel: "SMS00004".

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

-CollectionName

Geben Sie den Namen der Auflistung an, für die diese Anwendung bereitgestellt wird.

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

-Comment

Geben Sie einen optionalen Kommentar für diese Bereitstellung an.

Type:	String
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

-DeadlineDateTime

Geben Sie ein DateTime -Objekt für den Zeitpunkt an, zu dem diese Bereitstellung zugewiesen ist, auch als _Stichtag_bezeichnet. Verwenden Sie zum Abrufen dieses Objekts das integrierte Cmdlet "Get-Date".

Verwenden Sie "-AvailableDateTime", um anzugeben, wann die Bereitstellung _verfügbar_ist.

Type:	DateTime
Aliases:	SupersedenceDeadlineDateTime
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeployAction

Geben Sie die Bereitstellungsaktion an, um die Anwendung zu installieren oder zu deinstallieren. Wenn im Wettbewerb stehende Bereitstellungen auf dasselbe Gerät ausgerichtet sind, hat die Installationsaktion Priorität.

Type:	DeployActionType
Accepted values:	Install, Uninstall
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeployPurpose

Geben Sie den Bereitstellungszweck an:

• Available: Der Benutzer sieht die Anwendung im Software Center. Sie können es bei Bedarf installieren.

• Required: Der Client installiert die App automatisch gemäß dem von Ihnen festgelegten Zeitplan. Wenn die Anwendung nicht ausgeblendet ist, kann ein Benutzer den Bereitstellungsstatus nachverfolgen. Sie können auch Software Center verwenden, um die Anwendung vor Ablauf des Stichtags zu installieren.

Type:	DeployPurposeType
Accepted values:	Available, Required
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableContentDependencyDetection

Fügen Sie diesen Parameter hinzu, um Inhalte für abhängige Apps nicht automatisch zu verteilen.

Type:	SwitchParameter
Aliases:	DisableDetectAssociatedContentDependencies
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

-DistributeCollectionName

Die Website verteilt Inhalte an die Verteilungspunkte, die diesem Sammlungsnamen zugeordnet sind.

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

-DistributeContent

Fügen Sie diesen Parameter hinzu, wenn Sie den App-Inhalt zuerst verteilen müssen.

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

-DistributionPointGroupName

Geben Sie zum Verteilen des Anwendungsinhalts den Namen einer Verteilerpunktgruppe an.

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

-DistributionPointName

Geben Sie zum Verteilen des Anwendungsinhalts den Namen eines Verteilungspunkts an.

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

-EnableMomAlert

Legen Sie diesen Parameter $true fest, um System Center Operations Manager-Wartungsmodus für diese Bereitstellung zu aktivieren.

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

-EnableSoftDeadline

Legen Sie diesen Parameter $true fest, um die verzögerte Erzwingung zu aktivieren.

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

-FailParameterValue

Gibt den Prozentsatz der fehlgeschlagenen Anwendungsinstallation an, die eine Warnung auslöst. Geben Sie eine ganze Zahl zwischen 1 und 100 an. Um diese Warnung zu aktivieren, legen Sie den Parameter CreatAlertBaseOnPercentFailure auf $True .

Type:	Int32
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 (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.

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

-GenerateScomAlertOnFailure

Gibt an, ob eine Operations Manager-Warnung erstellt werden soll, wenn ein Client die Anwendung nicht installieren kann.

Type:	Boolean
Aliases:	RaiseMomAlertsOnFailure
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

Geben Sie die ID der bereitzustellenden Anwendung an.

Type:	Int32
Aliases:	CIId, CI_ID, ApplicationId
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Geben Sie ein bereitzustellende Anwendungsobjekt an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet "Get-CMApplication".

Type:	IResultObject
Aliases:	Application
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Geben Sie den Namen der bereitzustellenden Anwendung an.

Type:	String
Aliases:	LocalizedDisplayName, ApplicationName
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-OverrideServiceWindow

Gibt an, ob die Bereitstellung auch dann stattfindet, wenn sie außerhalb eines Wartungsfensters geplant ist. Ein Wartungsfenster ist ein angegebener Zeitraum, der für die Computerwartung und Updates verwendet wird. Ist dies der $True Fall, stellt Configuration Manager die Anwendung auch dann bereit, wenn die geplante Zeit außerhalb des Wartungsfensters liegt. Wenn dieser Wert $False lautet, stellt Configuration Manager die Anwendung nicht außerhalb des Fensters bereit. Es wartet, bis es in einem verfügbaren Fenster bereitgestellt werden kann.

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

-PersistOnWriteFilterDevice

Gibt an, ob Schreibfilter für eingebettete Geräte aktiviert werden sollen. Bei einem Wert von $True , führt das Gerät während eines Wartungsfensters einen Commit für Änderungen aus. Diese Aktion erfordert einen Neustart. Bei einem Wert von $False speichert das Gerät Änderungen in einer Überlagerung und führt später einen Commit durch.

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

-PostponeDateTime

Wenn Sie CreateAlertBaseOnPercentSuccess $true festlegen, verwenden Sie diesen Parameter, um ein DateTime -Objekt anzugeben. Configuration Manager erstellt eine Bereitstellungswarnung, wenn der Schwellenwert nach diesem Datum niedriger als der SuccessParameterValue ist.

Verwenden Sie zum Abrufen dieses Objekts das integrierte Cmdlet "Get-Date".

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

-PreDeploy

Gibt an, ob die Anwendung vorab auf dem primären Gerät des Benutzers bereitgestellt werden soll.

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

-RebootOutsideServiceWindow

Gibt an, ob ein Computer außerhalb eines Wartungsfensters neu gestartet wird. Ein Wartungsfenster ist ein angegebener Zeitraum, der für die Computerwartung und Updates verwendet wird. Ist dies der $True Fall, erfolgt ein erforderlicher Neustart ohne Berücksichtigung der Wartungsfenster. Ist $False dies der Fall, wird der Computer außerhalb eines Wartungsfensters nicht neu gestartet.

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

-ReplaceToastNotificationWithDialog

Wenn erforderliche Software auf dem Client verfügbar ist, legen Sie diesen Parameter so fest, $true dass die standardmäßigen Popupbenachrichtigungen durch ein Dialogfeld ersetzt werden. Der Wert ist standardmäßig "false". Weitere Informationen finden Sie unter Ersetzen von Popupbenachrichtigungen durch dialogfeld.

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

-SendWakeupPacket

Gibt an, ob ein Reaktivierungspaket an Computer gesendet werden soll, bevor die Bereitstellung beginnt. Wenn dieser Wert $True ist, versucht Configuration Manager, einen Computer aus dem Ruhezustand zu reaktiviert. Wenn dieser Wert $False ist, werden Computer nicht aus dem Ruhezustand aktiviert. Damit Computer aktiviert werden können, müssen Sie zuerst "Wake On LAN" konfigurieren.

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

-Simulation

Fügen Sie diesen Parameter hinzu, um eine Bereitstellungssimulation zu erstellen. Weitere Informationen finden Sie unter Simulieren von Anwendungsbereitstellungen mit Configuration Manager.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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 $True .

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

-TimeBaseOn

Gibt an, welche Zeitzone verwendet werden soll:

• LocalTime: Ortszeit verwenden.
• UTC: Koordinierte Weltzeit (COORDINATED Universal Time, UTC) verwenden.

Type:	TimeType
Accepted values:	LocalTime, Utc
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UpdateSupersedence

Verwenden Sie für eine verfügbare Bereitstellung diesen Parameter, um den Installationstermin für das Upgrade von Benutzern oder Geräten anzugeben, auf denen die abgelöste Anwendung installiert ist. Verwenden Sie DeadlineDateTime, um einen bestimmten Zeitpunkt anzugeben, andernfalls so bald wie möglich nach availableDateTime.

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

-UseMeteredNetwork

Gibt an, ob Clients das Herunterladen von Inhalten über eine getaktete Internetverbindung nach Ablauf des Stichtags erlauben, was zusätzliche Kosten verursachen kann.

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

-UserNotification

Gibt den Typ der Benutzerbenachrichtigung an.

• DisplayAll: Im Software Center anzeigen und alle Benachrichtigungen anzeigen.
• DisplaySoftwareCenterOnly: Wird im Software Center angezeigt und zeigt nur Benachrichtigungen über Computerneustarts an.
• HideAll: Ausblenden im Software Center und aller Benachrichtigungen.

Type:	UserNotificationType
Accepted values:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
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

System.Object

Ähnliche Themen

• Get-CMApplication
• Get-CMApplicationDeployment
• Remove-CMApplicationDeployment
• Set-CMApplicationDeployment
• Bereitstellen von Anwendungen mit Configuration Manager