Dela via


Set-CMAutoDeploymentRuleDeployment

SYNOPSIS

Anger en distribution för en regel för automatisk distribution.

SYNTAX

ByValue (standard)

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

Cmdleten Set-CMAutoDeploymentRuleDeployment uppdaterar en distribution för en regel för automatisk distribution.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Ange en distribution efter 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

Det här kommandot uppdaterar inställningarna för distributionen av distributionsregeln med åtgärds-ID 348 och samlingen med namnet Alla system.

Exempel 2: Ange en distribution med hjälp av en variabel

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

Det första kommandot hämtar regelobjektet för automatisk distribution med namnet TestADR01 och lagrar objektet i $ReferenceADR variabeln.

Det andra kommandot hämtar de distributioner som är associerade med regelobjektet för automatisk distribution som lagras i $ReferenceADR och lagrar distributionerna i $Deployment variabeln.

Det sista kommandot uppdaterar inställningarna för den första distributionen som lagras i $Deployment.

PARAMETERS

-AlertTime

Anger antalet tidsenheter för förskjutningen från tidsgränsen.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-AlertTimeUnit

Anger tidsenhetstyp för förskjutningen från tidsgränsen. Giltiga värden är:

  • Tider
  • Dagar
  • Veckor
  • Månader
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

Från och med version 1906 använder du den här parametern för att ange följande alternativ på sidan Hämta Inställningar i distributionsinställningarna för den automatiska distributionsregeln: Om programuppdateringar inte är tillgängliga på distributionsplatsen i aktuella grupper, granngrupper eller platsgränsgrupper laddar du ned innehåll från Microsoft Updates .

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowRestart

Anger om en systemstart tillåts utföras utanför definierade underhållsfönster när tidsgränsen för installationen nås.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowSoftwareInstallationOutsideMaintenanceWindow

Anger om programinstallationen får utföras utanför definierade underhållsfönster när tidsgränsen för installationen nås.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowUseMeteredNetwork

Från och med version 1906 använder du den här parametern för att ange följande alternativ på sidan Ladda ned Inställningar i distributionsinställningarna för automatisk distribution: Tillåt klienter på en Internet-anslutning med dataförbrukning att ladda ned innehåll efter installationens tidsgräns, vilket kan medföra ytterligare kostnader

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AvailableImmediately

Anger om programuppdateringar är tillgängliga för installation så snart som möjligt efter att regeln har körts.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AvailableTime

Anger antalet tidsenheter för programvarans tillgängliga tid.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-AvailableTimeUnit

Anger tidsenhetstypen för programvarans tillgängliga tid. Giltiga värden är:

  • Tider
  • Dagar
  • Veckor
  • Månader
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

-Samling

Anger ett målsamlingsobjekt för programuppdateringsdistributionen. Om du vill hämta ett samlingsobjekt använder du cmdleten Get-CMCollection.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-CollectionId

Anger ID för målsamlingen för programuppdateringsdistributionen.

Type: String
Parameter Sets: (All)
Aliases:

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

-CollectionName

Anger namnet på målsamlingen för programuppdateringsdistributionen.

Type: String
Parameter Sets: (All)
Aliases:

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

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

-DeadlineImmediately

Anger om nödvändiga programuppdateringar installeras så snart som möjligt när tidsgränsen nås.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-DeadlineTime

Anger antalet tidsenheter för tidsgränsen.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DeadlineTimeUnit

Anger tidsenhetstyp för tidsgränsen. Giltiga värden är:

  • Tider
  • Dagar
  • Veckor
  • Månader
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

Anger om Operations Manager är inaktiverade när programuppdateringar körs.

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

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

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-EnableDeployment

Anger om du vill aktivera distributionen efter att den här regeln har körs för den associerade programvarugruppen. Om det är $False måste du distribuera programuppdateringsgruppen manuellt.

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

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-GenerateOperationsManagerAlert

Anger om Operations Manager genereras när en programuppdateringsinstallation misslyckas.

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

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

-GenerateSuccessAlert

Anger om en avisering genereras när den här regeln körs.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Id

Anger åtgärds-ID för distribution av regler för automatisk distribution.

Type: Int32
Parameter Sets: ById
Aliases: ActionID

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

-InputObject

Anger ett regelobjekt för automatisk distribution. Om du vill hämta ett regelobjekt för automatisk distribution använder du cmdleten 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

Anger om programuppdateringar ska installeras när uppdateringarna inte är tillgängliga på några fjärrdistributionsplatser.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-NoInstallOnUnprotected

Anger om programuppdateringar ska installeras när uppdateringarna inte är tillgängliga på oskyddade distributionsplatser.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-PassThru

Lägg till den här parametern för att returnera ett objekt som representerar det objekt som du arbetar med. Som standard genererar denna cmdlet kanske inte några utdata.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-RequirePostRebootFullScan

Från och med version 1906 använder du den här parametern för att ange följande alternativ på sidan Användarupplevelse i distributionsinställningarna för den automatiska distributionsregeln: Om någon uppdatering i den här distributionen kräver en systemstart kör du utvärderingscykeln för uppdateringsdistribution efter omstart.

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

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

-SendWakeupPacket

Anger om wake-on-LAN ska användas för att väcka klienter för nödvändiga distributioner.

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

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

-SoftDeadlineEnabled

Från och med version 1906 använder du den här parametern för att ange följande alternativ på sidan Distributionsschema för distributionsinställningarna för automatisk distribution: Fördröj tillämpningen av den här distributionen enligt användarinställningar fram till respitperioden som definierats i klientinställningarna.

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

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

-SuccessPercentage

Anger procent, som ett heltal, för klientefterlevnad. När klientefterlevnaden understiger den här procentandelen genereras en avisering.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-SuppressRestartServer

Anger om en systemstart ignoreras på servrar när en programuppdatering kräver en systemstart för att slutföra installationsprocessen.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-SuppressRestartWorkstation

Anger om en systemstart ignoreras på arbetsstationer när en programuppdatering kräver en omstart av systemet för att slutföra installationsprocessen.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UseBranchCache

Anger om klienter tillåts dela innehåll med andra klienter i samma undernät.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UseUtc

Anger om schemat för den här distributionen utvärderas baserat på UTC (Universal Coordinated Time).

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UserNotification

Anger meddelandebeteendet för den visuella användarupplevelsen. Giltiga värden är:

  • 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

Anger hur mycket tillstånd som klienter rapporterar tillbaka för distributioner som skapats av den här regeln. Giltiga värden är:

  • 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

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

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

-WriteFilterHandling

Anger om ändringar har gjorts inom tidsgränsen eller under en underhållsfönstret (kräver omstarter). Om det är $False tillämpas innehållet på överlägget och int anges senare.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_AdrDeploymentSettings

ANTECKNINGAR

Get-CMCollection

Get-CMAutoDeploymentRuleDeployment

Get-CMSoftwareUpdateAutoDeploymentRule

New-CMAutoDeploymentRuleDeployment

Remove-CMAutoDeploymentRuleDeployment