Set-CMPackageDeployment
Ändert Werte, die definieren, wie Configuration Manager ein Softwarepaket bereitstellt.
Syntax
Set-CMPackageDeployment
[-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>]
[-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-EnableExpireSchedule <Boolean>]
[-FastNetworkOption <FastNetworkOptionType>]
-InputObject <IResultObject>
[-PersistOnWriteFilterDevice <Boolean>]
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType[]>]
[-SendWakeupPacket <Boolean>]
[-SlowNetworkOption <SlowNetworkOptionType>]
[-SoftwareInstallation <Boolean>]
-StandardProgramName <String>
[-SystemRestart <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMPackageDeployment
[-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>]
[-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-EnableExpireSchedule <Boolean>]
[-FastNetworkOption <FastNetworkOptionType>]
-PackageName <String>
[-PersistOnWriteFilterDevice <Boolean>]
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType[]>]
[-SendWakeupPacket <Boolean>]
[-SlowNetworkOption <SlowNetworkOptionType>]
[-SoftwareInstallation <Boolean>]
-StandardProgramName <String>
[-SystemRestart <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMPackageDeployment
[-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>]
[-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>]
[-DeploymentExpireDateTime <DateTime>]
[-EnableExpireSchedule <Boolean>]
[-FastNetworkOption <FastNetworkOptionType>]
-PackageId <String>
[-PersistOnWriteFilterDevice <Boolean>]
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType[]>]
[-SendWakeupPacket <Boolean>]
[-SlowNetworkOption <SlowNetworkOptionType>]
[-SoftwareInstallation <Boolean>]
-StandardProgramName <String>
[-SystemRestart <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMPackageDeployment
[-Comment <String>]
[-DeploymentStartDateTime <DateTime>]
-DeviceProgramName <String>
-PackageName <String>
[-RecurUnit <RecurUnitType>]
[-RecurValue <Int32>]
[-Rerun <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseRecurrencePattern <Boolean>]
[-UseUtc <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMPackageDeployment
[-Comment <String>]
[-DeploymentStartDateTime <DateTime>]
-DeviceProgramName <String>
-PackageId <String>
[-RecurUnit <RecurUnitType>]
[-RecurValue <Int32>]
[-Rerun <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseRecurrencePattern <Boolean>]
[-UseUtc <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMPackageDeployment
[-Comment <String>]
[-DeploymentStartDateTime <DateTime>]
-DeviceProgramName <String>
-InputObject <IResultObject>
[-RecurUnit <RecurUnitType>]
[-RecurValue <Int32>]
[-Rerun <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-UseRecurrencePattern <Boolean>]
[-UseUtc <Boolean>]
[-PassThru]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Cmdlet Set-CMPackageDeployment ändert Werte, die definieren, wie Configuration Manager ein Softwarepaket bereitstellt. Eine Bereitstellung umfasst eine Sammlung von Geräten oder Benutzern, ein bereitzustellende Paket und entweder einen Geräteprogrammnamen oder einen Standardprogrammnamen. Um anzugeben, welche Bereitstellung geändert werden soll, geben Sie den Sammlungsnamen, das Paket und den Programmnamen an. Sie können das Paket nach Name oder ID angeben, oder Sie können das Cmdlet Get-CMPackage verwenden, um ein Paketobjekt abzurufen.
Hinweis
Führen Sie Configuration Manager Cmdlets auf dem Configuration Manager-Websitelaufwerk aus, z. PS XYZ:\>
B. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 1: Festlegen von Serieneigenschaften
PS XYZ:\> Set-CMPackageDeployment -CollectionName "All Systems" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -RecurUnit Hours -RecurValue 7 -UseRecurrencePattern $True
Dieser Befehl nimmt Änderungen an der Bereitstellung vor, die von der Sammlung mit dem Namen Alle Systeme, dem Geräteprogramm mit dem Namen DPM und dem Paket mit dem Namen User State Migration Tool für Windows 8 angegeben wird. Der Befehl legt den Parameter UseRecurrencePattern auf den Wert $True fest. Der Befehl gibt eine Wiederholungseinheit von Stunden und einen Wiederholungswert von sieben an. Daher wird die Bereitstellung alle sieben Stunden wiederholt.
Beispiel 2: Festlegen des Verfügbarkeitstags und der Verfügbarkeitszeit
PS XYZ:\> Set-CMPackageDeployment -CollectionName "All Systems" -PackageName "User State Migration Tool for Windows 8" -StandardProgramName "SPM" -DeploymentAvailableDay 2012/10/18 -DeploymentAvailableTime 15:41 -UseUtcForAvailableSchedule $False
Dieser Befehl nimmt Änderungen an der Bereitstellung vor, die von der Sammlung mit dem Namen Alle Systeme, dem Paket mit dem Namen User State Migration Tool for Windows 8 und dem Standardprogramm namens SPM angegeben wird. Der Befehl gibt einen Tag und eine Uhrzeit an, zu dem die Bereitstellung verfügbar wird. Der Befehl gibt auch an, dass die Bereitstellung keine UTC für den Verfügbarkeitszeitplan verwendet. Der Zeitplan bezieht sich auf die lokale Zeitzone.
Parameter
-AllowFallback
{{ Fill AllowFallback Description }}
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowSharedContent
Gibt an, ob Clients freigegebene Inhalte verwenden. Wenn dieser Wert $True ist, versuchen Clients, Inhalte von anderen Clients herunterzuladen, die diesen Inhalt heruntergeladen haben. Wenn dieser Wert $False ist, versuchen Clients nicht, von anderen Clients herunterzuladen.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
Gibt die Benutzersammlung an.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
Gibt die ID eines Geräts oder einer Benutzersammlung an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Gibt die ID eines Geräts oder einer Benutzersammlung an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Comment
Gibt einen Kommentar für die Bereitstellung an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
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: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentAvailableDateTime
Gibt als DateTime-Objekt das Datum und die Uhrzeit an, zu denen die Bereitstellung verfügbar wird. Verwenden Sie das Cmdlet Get-Date, um ein DateTime-Objekt abzurufen.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentExpireDateTime
Gibt als DateTime-Objekt das Datum und die Uhrzeit des Ablaufs der Bereitstellung an. Verwenden Sie das Cmdlet Get-Date, um ein DateTime-Objekt abzurufen.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentStartDateTime
Gibt als DateTime-Objekt das Datum und die Uhrzeit des Beginns der Bereitstellung an. Verwenden Sie das Cmdlet Get-Date, um ein DateTime-Objekt abzurufen.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeviceProgramName
Gibt den Namen eines Geräteprogramms an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableExpireSchedule
Gibt an, ob der Zeitplan für das Ablaufen der Bereitstellung aktiviert werden soll.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FastNetworkOption
Gibt das Clientverhalten in einem schnellen Netzwerk an. Folgende Werte sind für diesen Parameter zulässig:
- DownloadContentFromDistributionPointAndRunLocally
- RunProgramFromDistributionPoint
Type: | FastNetworkOptionType |
Accepted values: | RunProgramFromDistributionPoint, DownloadContentFromDistributionPointAndRunLocally |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Gibt ein Paketobjekt an.
Type: | IResultObject |
Aliases: | Package, DeploymentSummary, Advertisement |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PackageId
Gibt die ID eines Pakets an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PackageName
Gibt den Namen eines Pakets an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Gibt das aktuelle Arbeitsobjekt zurück. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
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 übernimmt das Gerät Änderungen während eines Wartungsfensters. Diese Aktion erfordert einen Neustart. Bei einem Wert von $False speichert das Gerät Änderungen in einer Überlagerung und committet sie später.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RecurUnit
Gibt eine Einheit für eine wiederkehrende Bereitstellung an. Folgende Werte sind für diesen Parameter zulässig:
- Tage
- Stunden
- Minuten
Type: | RecurUnitType |
Accepted values: | Minutes, Hours, Days |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RecurValue
Gibt an, wie oft eine Bereitstellung wiederholt wird. Dieser Parameter hängt vom im RecurUnit-Parameter angegebenen Einheitentyp ab. Dieser Wert kann zwischen 1 und 23 betragen, wenn die Einheit Stunden ist, zwischen 1 und 31, wenn die Einheit Tage ist, oder zwischen 1 und 59, wenn die Einheit Minuten ist.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Rerun
Gibt an, ob die Bereitstellung erneut ausgeführt wird. Wenn dieser Wert $True ist, wird die Bereitstellung für Clients erneut ausgeführt, wie im RerunBehavior-Parameter angegeben. Wenn dieser Wert $False ist, wird die Bereitstellung nicht erneut ausgeführt.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RerunBehavior
Gibt an, wie eine Bereitstellung auf einem Client erneut ausgeführt wird. Folgende Werte sind für diesen Parameter zulässig:
- AlwaysRerunProgram. Führen Sie die Ausführung wie geplant erneut aus, auch wenn die Bereitstellung erfolgreich war. Sie können diesen Wert für wiederkehrende Bereitstellungen verwenden.
- NeverRerunDeployedProgram. Wird nicht erneut ausgeführt, auch wenn die Bereitstellung fehlgeschlagen ist oder Dateien geändert wurden.
- RerunIfFailedPreviousAttempt. Führen Sie wie geplant erneut aus, wenn die Bereitstellung beim vorherigen Versuch fehlgeschlagen ist.
- RerunIfSucceededOnpreviousAttempt. Führen Sie nur dann erneut aus, wenn der vorherige Versuch erfolgreich war. Sie können diesen Wert für Updates verwenden, die vom vorherigen Update abhängen.
Type: | RerunBehaviorType |
Accepted values: | NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunFromSoftwareCenter
Gibt an, ob über das Softwarecenter ausgeführt werden soll.
Type: | Boolean |
Aliases: | AllowUsersRunIndependently |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Schedule
Gibt ein CMSchedule-Objekt an. Der Zeitplan gibt an, wann das Wartungsfenster auftritt. Verwenden Sie zum Erstellen eines CMSchedule-Objekts das Cmdlet New-CMSchedule .
Type: | IResultObject[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScheduleEvent
Gibt ein Array von Zeitplanereignistypen an. Folgende Werte sind für diesen Parameter zulässig:
- AsSoonAsPossible
- Abmelden
- Anmeldung
- SendWakeUpPacket
Type: | ScheduleEventType[] |
Accepted values: | AsSoonAsPossible, LogOn, LogOff |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SendWakeupPacket
Gibt an, ob vor Beginn der Bereitstellung ein Aktivierungspaket an Computer gesendet werden soll. Wenn dieser Wert $True ist, aktiviert Configuration Manager einen Computer aus dem Standbymodus. Wenn dieser Wert $False ist, werden Computer nicht aus dem Standbymodus reaktiviert. Damit Computer reaktivieren können, müssen Sie zuerst Wake-On-LAN konfigurieren.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SlowNetworkOption
Gibt an, wie Configuration Manager dieses Paket in einem langsamen Netzwerk bereitstellt. Folgende Werte sind für diesen Parameter zulässig:
- DoNotRunProgram
- DownloadContentFromDistributionPointAndLocally
- RunProgramFromDistributionPoint
Type: | SlowNetworkOptionType |
Accepted values: | DoNotRunProgram, DownloadContentFromDistributionPointAndLocally, RunProgramFromDistributionPoint |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareInstallation
Gibt an, ob die bereitgestellte Software außerhalb von Wartungsfenstern installiert werden soll. Ein Wartungsfenster ist ein festgelegter Zeitraum, der für die Computerwartung und -updates verwendet wird. Wenn dieser Wert $True ist, installiert die Configuration Manager Software gemäß dem Zeitplan, auch wenn der Zeitplan außerhalb eines Wartungsfensters liegt. Wenn dieser Wert $False ist, installiert Configuration Manager die bereitgestellte Software nicht außerhalb von Fenstern, sondern wartet auf ein Wartungsfenster.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StandardProgramName
Gibt einen Standardprogrammnamen an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SystemRestart
Gibt an, ob ein System 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 $True ist, erfolgt jeder erforderliche Neustart ohne Berücksichtigung von Wartungsfenstern. Wenn dieser Wert $False ist, wird der Computer nicht außerhalb eines Wartungsfensters neu gestartet.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseMeteredNetwork
{{ Fill UseMeteredNetwork Description }}
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseRecurrencePattern
Gibt an, ob ein Serienmuster verwendet werden soll.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseUtc
Gibt an, ob koordinierte Weltzeit (UTC) verwendet werden soll, die auch als Greenwich Mean Time (Greenwich Mean Time) bezeichnet wird. Wenn dieser Wert $True ist, verwendet Configuration Manager utc für diese Bereitstellung. Wenn dieser Wert $False ist, verwendet Configuration Manager ortszeit.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseUtcForAvailableSchedule
Gibt an, ob UTC für den verfügbaren Zeitplan verwendet werden soll. Wenn dieser Wert $True ist, verwendet Configuration Manager UTC. Wenn dieser Wert $False ist, verwendet Configuration Manager ortszeit.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseUtcForExpireSchedule
Gibt an, ob UTC für den Ablaufzeitplan verwendet werden soll. Wenn dieser Wert $True ist, verwendet Configuration Manager UTC. Wenn dieser Wert $False ist, verwendet Configuration Manager ortszeit.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
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: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
System.Object
Ähnliche Themen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für