Freigeben über


New-CMApplicationDeployment

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 auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Installieren einer Anwendung

Dieser Befehl erstellt eine neue Bereitstellung für Visual Studio 2019 in der Sammlung Entwicklerarbeitsstation. Sie installiert die App und ist erforderlich. Sowohl das verfügbare Datum als auch der Stichtag befinden sich in der Vergangenheit. Sobald der Client diese Richtlinie erhält, installiert er die App.

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 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

-ApprovalRequired

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

-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 diese 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 diese Anwendung bereitgestellt wird.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-Comment

Geben Sie einen optionalen Kommentar für diese 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: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
Aliase:SupersedenceDeadlineDateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeployAction

Geben Sie die Bereitstellungsaktion an, um die Anwendung zu installieren oder zu deinstallieren. Wenn konkurrierende Bereitstellungen auf dasselbe Gerät abzielen, hat die Aktion Installieren Priorität.

Typ:DeployActionType
Zulässige Werte:Install, Uninstall
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeployPurpose

Geben Sie den Bereitstellungszweck an:

  • Available: Der Benutzer sieht die Anwendung im Softwarecenter. 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 seinen Bereitstellungsstatus nachverfolgen. Sie können auch das Softwarecenter verwenden, um die Anwendung vor dem Stichtag zu installieren.

Typ:DeployPurposeType
Zulässige Werte:Available, Required
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableContentDependencyDetection

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

Typ:SwitchParameter
Aliase:DisableDetectAssociatedContentDependencies
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

-DistributeCollectionName

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DistributeContent

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DistributionPointGroupName

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DistributionPointName

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

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

-GenerateScomAlertOnFailure

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

Typ:Boolean
Aliase:RaiseMomAlertsOnFailure
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Id

Geben Sie die ID der bereitzustellenden Anwendung an.

Typ:Int32
Aliase:CIId, CI_ID, ApplicationId
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

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

Typ:IResultObject
Aliase:Application
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Geben Sie den Namen der bereitzustellenden Anwendung an.

Typ:String
Aliase:LocalizedDisplayName, ApplicationName
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
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

-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

-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

-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

-Simulation

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

Typ:SwitchParameter
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

-UpdateSupersedence

Verwenden Sie für eine verfügbare Bereitstellung diesen Parameter, um den Installationsstichtag für Das Upgrade von Benutzern oder Geräten anzugeben, auf denen die abgelöste Anwendung installiert ist. Verwenden Sie DeadlineDateTime , um eine bestimmte Uhrzeit anzugeben, andernfalls so schnell wie möglich nach AvailableDateTime.

Typ:Boolean
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:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object