Freigeben über

New-CMAutoDeploymentRuleDeployment

  • Referenz
Modul:
ConfigurationManager

Erstellen Sie eine Bereitstellung für eine automatische Bereitstellungsregel.

Syntax

New-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>]
   [-Name] <String>
   [-NoInstallOnRemote <Boolean>]
   [-NoInstallOnUnprotected <Boolean>]
   [-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>]
New-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>]
   [-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>]
New-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>]
   [-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 New-CMAutoDeploymentRuleDeployment erstellt eine Bereitstellung für eine automatische Bereitstellungsregel (ADR).

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: Erstellen einer Bereitstellung für eine automatische Bereitstellungsregel anhand des Namens

Dieser Befehl erstellt eine Bereitstellung für die automatische Bereitstellungsregel TestDepRule01 und die Sammlung Alle Systeme .

New-CMAutoDeploymentRuleDeployment -Name "TestDepRule01" -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

Beispiel 2: Erstellen einer Bereitstellung für eine automatische Bereitstellungsregel nach Objekt

Dieser Befehl ruft das Objekt der automatischen Bereitstellungsregel mit dem Namen TestDepRule02 ab. Anschließend wird der Pipelineoperator verwendet, um das Objekt an New-CMAutoDeploymentRuleDeployment zu übergeben, wodurch eine Bereitstellung für die automatische Bereitstellungsregel TestDepRule02 und die All Systems-Auflistung erstellt wird.

Get-CMAutoDeploymentRule -Name "TestDepRule02" | New-CMAutoDeploymentRuleDeployment -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

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.

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.

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.

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 $Falsefestgelegt ist, stellen Sie die Softwareupdategruppe manuell bereit.

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 ID der automatischen Bereitstellungsregel an, der diese Bereitstellung hinzugefügt werden soll.

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

-InputObject

Gibt ein Automatisches Bereitstellungsregelobjekt an, dem diese Bereitstellung hinzugefügt werden soll. Verwenden Sie zum Abrufen eines Regelobjekts für die automatische Bereitstellung das Cmdlet Get-CMSoftwareUpdateAutoDeploymentRule .

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

-Name

Gibt den Namen der automatischen Bereitstellungsregel an, der diese Bereitstellung hinzugefügt werden soll.

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

-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 als ganze Zahl der Clientkonformität 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.

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.

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