Set-CMAutoDeploymentRuleDeployment
Legt eine Bereitstellung für eine automatische Bereitstellungsregel fest.
Syntax
Set-CMAutoDeploymentRuleDeployment
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowDownloadFromMicrosoftUpdate <Boolean>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DisableOperationsManager <Boolean>]
[-EnableDeployment <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-InputObject] <IResultObject>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-PassThru]
[-RequirePostRebootFullScan <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationOption>]
[-UseUtc <Boolean>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMAutoDeploymentRuleDeployment
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowDownloadFromMicrosoftUpdate <Boolean>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DisableOperationsManager <Boolean>]
[-EnableDeployment <Boolean>]
[-GenerateOperationsManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-Id] <Int32>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-PassThru]
[-RequirePostRebootFullScan <Boolean>]
[-SendWakeupPacket <Boolean>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationOption>]
[-UseUtc <Boolean>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Beschreibung
Das Cmdlet Set-CMAutoDeploymentRuleDeployment aktualisiert eine Bereitstellung für eine automatische Bereitstellungsregel.
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 einer Bereitstellung nach ID
PS XYZ:\> Set-CMAutoDeploymentRuleDeployment -ID 348 -CollectionName "All Systems" -EnableDeployment $True -SendWakeupPacket $False -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $False -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $False -AllowRestart $False -SuppressRestartServer $False -SuppressRestartWorkstation $False -WriteFilterHandling $False -GenerateSuccessAlert $True -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $False -GenerateOperationsManagerAlert $False -NoInstallOnRemote $False -NoInstallOnUnprotected $False -UseBranchCache $FalseDieser Befehl aktualisiert die Einstellungen für die Bereitstellung der Bereitstellungsregel mit der Aktions-ID 348 und der Sammlung mit dem Namen Alle Systeme.
Beispiel 2: Festlegen einer Bereitstellung mithilfe einer Variablen
PS XYZ:\> $ReferenceADR = Get-CMAutoDeploymentRule -Name "TestADR01"
PS XYZ:\> $Deployment = $ReferenceADR | Get-CMAutoDeploymentRuleDeployment
PS XYZ:\> Set-CMAutoDeploymentRuleDeployment -InputObject $Deployment[0] -CollectionName "All Systems" -EnableDeployment $True -SendWakeupPacket $False -VerboseLevel OnlySuccessAndErrorMessages -UseUtc $False -AvailableTime 7 -AvailableTimeUnit Days -DeadlineTime 7 -DeadlineTimeUnit Days -UserNotification DisplaySoftwareCenterOnly -AllowSoftwareInstallationOutsideMaintenanceWindow $False -AllowRestart $False -SuppressRestartServer $False -SuppressRestartWorkstation $False -WriteFilterHandling $False -GenerateSuccessAlert $True -SuccessPercentage 10 -AlertTime 7 -AlertTimeUnit Days -DisableOperationsManager $False -GenerateOperationsManagerAlert $False -NoInstallOnRemote $False -NoInstallOnUnprotected $False -UseBranchCache $FalseDer erste Befehl ruft das Automatische Bereitstellungsregelobjekt mit dem Namen TestADR01 ab und speichert das Objekt in der variablen $ReferenceADR.
Der zweite Befehl ruft die Bereitstellungen ab, die dem in $ReferenceADR gespeicherten Objekt der automatischen Bereitstellungsregel zugeordnet sind, und speichert die Bereitstellungen in der variablen $Deployment.
Der letzte Befehl aktualisiert die Einstellungen für die erste Bereitstellung, die in $Deployment gespeichert ist.
Parameter
-AlertTime
Gibt die Anzahl der Zeiteinheiten für den Offset vom Stichtag an.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AlertTimeUnit
Gibt den Zeiteinheitstyp für den Offset vom Stichtag an. Gültige Werte sind:
- Stunden
- Tage
- Wochen
- Monate
| Type: | TimeUnitType |
| Accepted values: | Hours, Days, Weeks, Months |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowDownloadFromMicrosoftUpdate
Verwenden Sie diesen Parameter, um die folgende Option auf der Seite Downloadeinstellungen der ADR-Bereitstellungseinstellungen festzulegen: Wenn Softwareupdates auf dem Verteilungspunkt in aktuellen, benachbarten oder Standortbegrenzungsgruppen nicht verfügbar sind, laden Sie Inhalte von Microsoft Aktualisierungen herunter.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowRestart
Gibt an, ob ein Systemneustart außerhalb definierter Wartungsfenster ausgeführt werden darf, wenn der Installationsstichtag erreicht ist.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowSoftwareInstallationOutsideMaintenanceWindow
Gibt an, ob die Softwareinstallation außerhalb definierter Wartungsfenster ausgeführt werden darf, wenn der Installationsstichtag erreicht ist.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowUseMeteredNetwork
Verwenden Sie diesen Parameter, um die folgende Option auf der Seite Downloadeinstellungen der ADR-Bereitstellungseinstellungen festzulegen: Clients mit einer getakteten Internetverbindung das Herunterladen von Inhalten nach dem Installationsstichtag erlauben, was zusätzliche Kosten verursachen kann.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AvailableImmediately
Gibt an, ob Softwareupdates nach der Ausführung der Regel so bald wie möglich installiert werden können.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AvailableTime
Gibt die Anzahl der Zeiteinheiten für die verfügbare Softwarezeit an.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AvailableTimeUnit
Gibt den Zeiteinheitstyp für die verfügbare Softwarezeit an. Gültige Werte sind:
- Stunden
- Tage
- Wochen
- Monate
| Type: | TimeUnitType |
| Accepted values: | Hours, Days, Weeks, Months |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Collection
Gibt ein Zielsammlungsobjekt für die Softwareupdatebereitstellung an. Verwenden Sie zum Abrufen eines Auflistungsobjekts das Cmdlet Get-CMCollection .
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionId
Gibt die ID der Zielsammlung für die Softwareupdatebereitstellung an.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionName
Gibt den Namen der Zielsammlung für die Softwareupdatebereitstellung 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 |
-DeadlineImmediately
Gibt an, ob erforderliche Softwareupdates so bald wie möglich installiert werden, wenn der Stichtag erreicht ist.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeadlineTime
Gibt die Anzahl der Zeiteinheiten für den Stichtag an.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeadlineTimeUnit
Gibt den Zeiteinheitstyp für den Stichtag an. Gültige Werte sind:
- Stunden
- Tage
- Wochen
- Monate
| Type: | TimeUnitType |
| Accepted values: | Hours, Days, Weeks, Months |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableOperationsManager
Gibt an, ob Operations Manager-Warnungen deaktiviert sind, während Softwareupdates ausgeführt werden.
| Type: | Boolean |
| Aliases: | DisableOperationManager |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
-EnableDeployment
Gibt an, ob die Bereitstellung aktiviert werden soll, nachdem diese Regel für die zugeordnete Softwaregruppe ausgeführt wird. Wenn auf $False festgelegt ist, müssen Sie die Softwareupdategruppe manuell bereitstellen.
| Type: | Boolean |
| Aliases: | Enable, EnabledAfterCreate, EnableAfterCreate |
| 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 |
-GenerateOperationsManagerAlert
Gibt an, ob Operations Manager-Warnungen generiert werden, wenn eine Softwareupdateinstallation fehlschlägt.
| Type: | Boolean |
| Aliases: | GenerateOperationManagerAlert |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-GenerateSuccessAlert
Gibt an, ob eine Warnung generiert wird, wenn diese Regel erfolgreich ausgeführt wird.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
Gibt die Aktions-ID der Bereitstellung der automatischen Bereitstellungsregel an.
| Type: | Int32 |
| Aliases: | ActionID |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Gibt ein Automatisches Bereitstellungsregelobjekt an. Verwenden Sie zum Abrufen eines Regelobjekts für die automatische Bereitstellung das Cmdlet Get-CMSoftwareUpdateAutoDeploymentRule .
| Type: | IResultObject |
| Aliases: | AutoDeploymentRuleDeployment |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-NoInstallOnRemote
Gibt an, ob Softwareupdates installiert werden sollen, wenn die Updates nicht auf Remoteverteilungspunkten verfügbar sind.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoInstallOnUnprotected
Gibt an, ob Softwareupdates installiert werden sollen, wenn die Updates nicht auf ungeschützten Verteilungspunkten verfügbar sind.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequirePostRebootFullScan
Verwenden Sie diesen Parameter, um die folgende Option auf der Seite Benutzerfreundlichkeit der ADR-Bereitstellungseinstellungen festzulegen: Wenn ein Update in dieser Bereitstellung einen Systemneustart erfordert, führen Sie den Bereitstellungsauswertungszyklus updates nach dem Neustart aus.
| Type: | Boolean |
| Aliases: | RunEvaluationAfterRestart |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SendWakeupPacket
Gibt an, ob Wake-on-LAN zum Reaktivieren von Clients für erforderliche Bereitstellungen verwendet werden soll.
| Type: | Boolean |
| Aliases: | EnableWakeOnLan |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SoftDeadlineEnabled
Verwenden Sie diesen Parameter, um die folgende Option auf der Seite Bereitstellungszeitplan der ADR-Bereitstellungseinstellungen festzulegen: Erzwingung dieser Bereitstellung gemäß den Benutzereinstellungen bis zur in den Clienteinstellungen definierten Karenzzeit verzögern.
| Type: | Boolean |
| Aliases: | DelayEnforcementAndUpToGracePeriod |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SuccessPercentage
Gibt den Prozentsatz der Clientkonformität als ganze Zahl an. Wenn die Clientkonformität unter diesen Prozentsatz fällt, wird eine Warnung generiert.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SuppressRestartServer
Gibt an, ob ein Systemneustart auf Servern unterdrückt wird, wenn ein Softwareupdate einen Systemneustart erfordert, um den Installationsvorgang abzuschließen.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SuppressRestartWorkstation
Gibt an, ob ein Systemneustart auf Arbeitsstationen unterdrückt wird, wenn ein Softwareupdate einen Systemneustart erfordert, um den Installationsvorgang abzuschließen.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseBranchCache
Gibt an, ob Clients Inhalte für andere Clients im gleichen Subnetz freigeben dürfen.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserNotification
Gibt das Benachrichtigungsverhalten der visuellen Benutzeroberfläche an. Gültige Werte sind:
- DisplayAll
- DisplaySoftwareCenterOnly
- HideAll
| Type: | UserNotificationOption |
| Accepted values: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseUtc
Gibt an, ob der Zeitplan für diese Bereitstellung basierend auf der koordinierten Weltzeit (UTC) ausgewertet wird.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VerboseLevel
Gibt an, wie viele Statusdetails die Clients für Bereitstellungen melden, die von dieser Regel erstellt wurden. Gültige Werte sind:
- OnlyErrorMessages
- OnlySuccessAndErrorMessages
- AllMessages
| Type: | VerboseLevelType |
| Accepted values: | OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages |
| 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 |
-WriteFilterHandling
Gibt an, ob Änderungen zum Stichtag oder während eines Wartungsfensters committet werden (neustarts erforderlich). Wenn auf $False festgelegt ist, wird der Inhalt auf die Überlagerung angewendet und später committet.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
IResultObject
Ähnliche Themen
Feedback
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 unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für