Freigeben über

Set-CMAutoDeploymentRuleDeployment

  • Referenz
Modul:
ConfigurationManager

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-Standortlaufwerk aus, z. B PS XYZ:\>. . 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 $False

Dieser 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 $False

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

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

-AlertTimeUnit

Gibt den Zeiteinheitstyp für den Offset vom Stichtag an. Gültige Werte sind:

  • Stunden
  • Tage
  • Wochen
  • Monate
Typ:TimeUnitType
Zulässige Werte:Hours, Days, Weeks, Months
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 Updates herunter.

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

-AllowRestart

Gibt an, ob ein Systemneustart außerhalb definierter Wartungsfenster ausgeführt werden darf, wenn der Installationsstichtag erreicht ist.

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

-AllowSoftwareInstallationOutsideMaintenanceWindow

Gibt an, ob die Softwareinstallation außerhalb definierter Wartungsfenster ausgeführt werden darf, wenn der Installationsstichtag erreicht ist.

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

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

-AvailableImmediately

Gibt an, ob Softwareupdates nach der Ausführung der Regel so bald wie möglich installiert werden können.

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

-AvailableTime

Gibt die Anzahl der Zeiteinheiten für die verfügbare Softwarezeit an.

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

-AvailableTimeUnit

Gibt den Zeiteinheitstyp für die verfügbare Softwarezeit an. Gültige Werte sind:

  • Stunden
  • Tage
  • Wochen
  • Monate
Typ:TimeUnitType
Zulässige Werte:Hours, Days, Weeks, Months
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Collection

Gibt ein Zielsammlungsobjekt für die Softwareupdatebereitstellung an. Verwenden Sie zum Abrufen eines Auflistungsobjekts das Cmdlet Get-CMCollection .

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

-CollectionId

Gibt die ID der Zielsammlung für die Softwareupdatebereitstellung an.

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

-CollectionName

Gibt den Namen der Zielsammlung für die Softwareupdatebereitstellung 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

-DeadlineImmediately

Gibt an, ob erforderliche Softwareupdates so bald wie möglich installiert werden, wenn der Stichtag erreicht ist.

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

-DeadlineTime

Gibt die Anzahl der Zeiteinheiten für den Stichtag an.

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

-DeadlineTimeUnit

Gibt den Zeiteinheitstyp für den Stichtag an. Gültige Werte sind:

  • Stunden
  • Tage
  • Wochen
  • Monate
Typ:TimeUnitType
Zulässige Werte:Hours, Days, Weeks, Months
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableOperationsManager

Gibt an, ob Operations Manager-Warnungen deaktiviert sind, während Softwareupdates ausgeführt werden.

Typ:Boolean
Aliase:DisableOperationManager
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

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

Typ:Boolean
Aliase:Enable, EnabledAfterCreate, EnableAfterCreate
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

-GenerateOperationsManagerAlert

Gibt an, ob Operations Manager-Warnungen generiert werden, wenn eine Softwareupdateinstallation fehlschlägt.

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

-GenerateSuccessAlert

Gibt an, ob eine Warnung generiert wird, wenn diese Regel erfolgreich ausgeführt wird.

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

-Id

Gibt die Aktions-ID der Bereitstellung der automatischen Bereitstellungsregel an.

Typ:Int32
Aliase:ActionID
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Gibt ein Automatisches Bereitstellungsregelobjekt an. Verwenden Sie zum Abrufen eines Regelobjekts für die automatische Bereitstellung das Cmdlet Get-CMSoftwareUpdateAutoDeploymentRule .

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

-NoInstallOnRemote

Gibt an, ob Softwareupdates installiert werden sollen, wenn die Updates nicht auf Remoteverteilungspunkten verfügbar sind.

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

-NoInstallOnUnprotected

Gibt an, ob Softwareupdates installiert werden sollen, wenn die Updates nicht auf ungeschützten Verteilungspunkten verfügbar sind.

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

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

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

-SendWakeupPacket

Gibt an, ob Wake-on-LAN zum Reaktivieren von Clients für erforderliche Bereitstellungen verwendet werden soll.

Typ:Boolean
Aliase:EnableWakeOnLan
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

Typ:Boolean
Aliase:DelayEnforcementAndUpToGracePeriod
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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.

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

-SuppressRestartServer

Gibt an, ob ein Systemneustart auf Servern unterdrückt wird, wenn ein Softwareupdate einen Systemneustart erfordert, um den Installationsvorgang abzuschließen.

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

-SuppressRestartWorkstation

Gibt an, ob ein Systemneustart auf Arbeitsstationen unterdrückt wird, wenn ein Softwareupdate einen Systemneustart erfordert, um den Installationsvorgang abzuschließen.

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

-UseBranchCache

Gibt an, ob Clients Inhalte für andere Clients im gleichen Subnetz freigeben dürfen.

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

-UserNotification

Gibt das Benachrichtigungsverhalten der visuellen Benutzeroberfläche an. Gültige Werte sind:

  • DisplayAll
  • DisplaySoftwareCenterOnly
  • HideAll
Typ:UserNotificationOption
Zulässige Werte:DisplayAll, DisplaySoftwareCenterOnly, HideAll
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-UseUtc

Gibt an, ob der Zeitplan für diese Bereitstellung basierend auf der koordinierten Weltzeit (UTC) ausgewertet wird.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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
Typ:VerboseLevelType
Zulässige Werte:OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages
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

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

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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

IResultObject