Sdílet prostřednictvím

Set-CMAutoDeploymentRuleDeployment

  • Článek

SYNOPSIS

Nastaví nasazení pro pravidlo automatického nasazení.

SYNTAX

ByValue (výchozí)

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

ById

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

DESCRIPTION

Rutina set-CMAutoDeploymentRuleDeployment aktualizuje nasazení pro pravidlo automatického nasazení.

Poznámka

Použijte například rutiny Configuration Manager z Configuration Manager jednotky webu PS XYZ:\> . Další informace najdete v tématu Začínáme.

EXAMPLES

Příklad 1: nastavení nasazení podle 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

Tento příkaz aktualizuje nastavení nasazení pravidla nasazení s ID akce 348 a kolekcí s názvem všechny systémy.

Příklad 2: nastavení nasazení pomocí proměnné

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

První příkaz načte objekt pravidla automatického nasazení s názvem TestADR01 a uloží objekt do proměnné $ReferenceADR.

Druhý příkaz vrátí nasazení přidružená k objektu pravidla automatického nasazení uloženému v $ReferenceADR a uloží nasazení do proměnné $Deployment.

Poslední příkaz aktualizuje nastavení prvního nasazení uloženého v $Deployment.

PARAMETERS

-AlertTime

Určuje počet časových jednotek pro posun od konečného termínu.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AlertTimeUnit

Určuje typ časové jednotky pro posun od konečného termínu. Platné hodnoty jsou:

  • Hodiny
  • Dny
  • Týdny
  • Měsíce
Type: TimeUnitType
Parameter Sets: (All)
Aliases:
Accepted values: Hours, Days, Weeks, Months

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AllowDownloadFromMicrosoftUpdate

počínaje verzí 1906 použijte tento parametr pro nastavení následující možnosti na stránce stáhnout Nastavení nastavení nasazení ADR: pokud nejsou aktualizace softwaru dostupné v distribučním bodě v aktuálním, sousedním nebo hraničních skupinách lokality, stáhněte obsah z aktualizací společnosti Microsoft.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AllowRestart

Určuje, jestli je možné provést restart systému mimo jakákoli definovaná časová období údržby po dosažení konečného termínu instalace.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AllowSoftwareInstallationOutsideMaintenanceWindow

Určuje, zda může být instalace softwaru po dosažení konečného termínu instalace provedena mimo jakékoli definované časové období údržby.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AllowUseMeteredNetwork

počínaje verzí 1906 použijte tento parametr k nastavení následující možnosti na stránce stáhnout Nastavení nastavení nasazení ADR: umožňuje klientům na měřeném připojení k internetu stahovat obsah po uplynutí konečného termínu instalace, což může znamenat dodatečnou cenu .

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AvailableImmediately

Označuje, zda jsou aktualizace softwaru k dispozici pro instalaci co nejdříve po spuštění pravidla.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AvailableTime

Určuje počet časových jednotek pro čas dostupnosti softwaru.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AvailableTimeUnit

Určuje typ časové jednotky pro čas dostupnosti softwaru. Platné hodnoty jsou:

  • Hodiny
  • Dny
  • Týdny
  • Měsíce
Type: TimeUnitType
Parameter Sets: (All)
Aliases:
Accepted values: Hours, Days, Weeks, Months

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

– Kolekce

Určuje cílový objekt kolekce pro nasazení aktualizace softwaru. Chcete-li získat objekt kolekce, použijte rutinu Get-CMCollection .

Type: IResultObject
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CollectionId

Určuje ID cílové kolekce pro nasazení aktualizace softwaru.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CollectionName

Určuje název cílové kolekce pro nasazení aktualizace softwaru.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-DeadlineImmediately

Určuje, zda jsou požadované aktualizace softwaru nainstalovány co nejdříve po dosažení konečného termínu.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DeadlineTime

Určuje počet časových jednotek pro konečný termín.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DeadlineTimeUnit

Určuje typ časové jednotky pro konečný termín. Platné hodnoty jsou:

  • Hodiny
  • Dny
  • Týdny
  • Měsíce
Type: TimeUnitType
Parameter Sets: (All)
Aliases:
Accepted values: Hours, Days, Weeks, Months

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableOperationsManager

Určuje, zda jsou při spuštění aktualizací softwaru zakázány výstrahy Operations Manager.

Type: Boolean
Parameter Sets: (All)
Aliases: DisableOperationManager

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableWildcardHandling

Tento parametr považuje zástupné znaky jako literálové hodnoty znaků. Nejde kombinovat s ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-EnableDeployment

Určuje, jestli se má povolit nasazení po spuštění tohoto pravidla pro přidruženou skupinu softwaru. Pokud je nastavena na $False, je nutné ručně nasadit skupinu aktualizace softwaru.

Type: Boolean
Parameter Sets: (All)
Aliases: Enable, EnabledAfterCreate, EnableAfterCreate

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučujeme). Nejde kombinovat s DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-GenerateOperationsManagerAlert

Určuje, zda budou generovány výstrahy Operations Manager při neúspěšné instalaci aktualizace softwaru.

Type: Boolean
Parameter Sets: (All)
Aliases: GenerateOperationManagerAlert

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-GenerateSuccessAlert

Určuje, zda je při úspěšném spuštění tohoto pravidla vygenerována výstraha.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

– ID

Určuje ID akce nasazení pravidla automatického nasazení.

Type: Int32
Parameter Sets: ById
Aliases: ActionID

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

– Položky InputObject

Určuje objekt pravidla automatického nasazení. Chcete-li získat objekt pravidla automatického nasazení, použijte rutinu Get-CMSoftwareUpdateAutoDeploymentRule .

Type: IResultObject
Parameter Sets: ByValue
Aliases: AutoDeploymentRuleDeployment

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-NoInstallOnRemote

Určuje, zda se mají instalovat aktualizace softwaru, pokud nejsou aktualizace k dispozici na žádném ze vzdálených distribučních bodů.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-NoInstallOnUnprotected

Určuje, jestli se mají nainstalovat aktualizace softwaru, když nejsou aktualizace dostupné v žádném z nechráněných distribučních bodů.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

– PassThru

Přidejte tento parametr pro vrácení objektu, který představuje položku, se kterou pracujete. Ve výchozím nastavení tato rutina nemusí generovat žádný výstup.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RequirePostRebootFullScan

Počínaje verzí 1906 použijte tento parametr k nastavení následující možnosti na stránce činnost koncového uživatele v nastavení nasazení ADR: Pokud nějaká aktualizace v tomto nasazení vyžaduje restart systému, spusťte po restartování cyklus vyhodnocení nasazení aktualizací.

Type: Boolean
Parameter Sets: (All)
Aliases: RunEvaluationAfterRestart

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SendWakeupPacket

Určuje, zda používat funkci Wake-on-LAN k probuzení klientů pro požadovaná nasazení.

Type: Boolean
Parameter Sets: (All)
Aliases: EnableWakeOnLan

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SoftDeadlineEnabled

Počínaje verzí 1906 použijte tento parametr k nastavení následující možnosti na stránce plán nasazení v nastavení nasazení ADR: odložit vynucení tohoto nasazení podle uživatelských preferencí, až po období odkladu definované v nastavení klienta.

Type: Boolean
Parameter Sets: (All)
Aliases: DelayEnforcementAndUpToGracePeriod

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SuccessPercentage

Určuje procento kompatibility klienta jako celé číslo. Když dodržování předpisů klienta klesne pod toto procento, vygeneruje se výstraha.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SuppressRestartServer

Označuje, zda je restartování systému potlačeno na serverech, když aktualizace softwaru vyžaduje restart systému, aby bylo možné dokončit proces instalace.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SuppressRestartWorkstation

Označuje, zda je restart systému potlačen na pracovních stanicích, pokud aktualizace softwaru vyžaduje restart systému, aby bylo možné dokončit proces instalace.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UseBranchCache

Určuje, zda mohou klienti sdílet obsah s ostatními klienty ve stejné podsíti.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UseUtc

Označuje, zda se plán pro toto nasazení hodnotí na základě světového koordinovaného času (UTC).

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UserNotification

Určuje chování oznámení v uživatelském prostředí uživatele. Platné hodnoty jsou:

  • DisplayAll
  • DisplaySoftwareCenterOnly
  • HideAll
Type: UserNotificationOption
Parameter Sets: (All)
Aliases:
Accepted values: DisplayAll, DisplaySoftwareCenterOnly, HideAll

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-VerboseLevel

Určuje, kolik podrobností o stavu klienti hlásí zpět pro nasazení vytvořená tímto pravidlem. Platné hodnoty jsou:

  • OnlyErrorMessages
  • OnlySuccessAndErrorMessages
  • AllMessages
Type: VerboseLevelType
Parameter Sets: (All)
Aliases:
Accepted values: OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespustí.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-WriteFilterHandling

Určuje, zda jsou změny potvrzené v konečném termínu nebo během údržby (vyžaduje restart). Pokud je nastavená na $False, obsah se použije na překrytí a potvrdí se později.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement. ManagementProvider. IResultObject

OUTPUTS

IResultObject # SMS_AdrDeploymentSettings

POZNÁMKY

Get-CMCollection

Get-CMAutoDeploymentRuleDeployment

Get-CMSoftwareUpdateAutoDeploymentRule

New-CMAutoDeploymentRuleDeployment

Remove-CMAutoDeploymentRuleDeployment