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
RELATED LINKS
Get-CMAutoDeploymentRuleDeployment
Get-CMSoftwareUpdateAutoDeploymentRule