Dela via

Set-CMSoftwareUpdateAutoDeploymentRule

  • Artikel

SYNOPSIS

Ändra en regel för automatisk distribution (ADR) för programuppdateringar.

SYNTAX

SearchByNameMandatory (standard)

Set-CMSoftwareUpdateAutoDeploymentRule [-AddToExistingSoftwareUpdateGroup <Boolean>] [-AlertTime <Int32>]
 [-AlertTimeUnit <TimeUnitType>] [-AllowRestart <Boolean>]
 [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>] [-AllowUseMeteredNetwork <Boolean>]
 [-Architecture <ArchitectureType[]>] [-ArticleId <String[]>] [-AvailableImmediately <Boolean>]
 [-AvailableTime <Int32>] [-AvailableTimeUnit <TimeUnitType>] [-BulletinId <String[]>] [-CMTag <CMTagTypes[]>]
 [-CollectionName <String>] [-ContentSize <String[]>] [-CustomSeverity <SeverityType[]>]
 [-DateReleasedOrRevised <DateReleasedOrRevisedType>] [-DeadlineImmediately <Boolean>] [-DeadlineTime <Int32>]
 [-DeadlineTimeUnit <TimeUnitType>] [-DeploymentPackage <IResultObject>] [-DeploymentPackageName <String>]
 [-DeploymentRing <DeploymentRing>] [-DeployWithoutLicense <Boolean>] [-Description <String>]
 [-DisableOperationManager <Boolean>] [-DownloadFromInternet <Boolean>]
 [-DownloadFromMicrosoftUpdate <Boolean>] [-Enable <Boolean>] [-EnabledAfterCreate <Boolean>] [-Force]
 [-GenerateFailureAlert <Boolean>] [-GenerateOperationManagerAlert <Boolean>] [-GenerateSuccessAlert <Boolean>]
 [-Language <String[]>] [-LanguageSelection <String[]>] [-Location <String>] [-MicrosoftAsVendor <Boolean>]
 -Name <String> [-NewName <String>] [-NoInstallOnRemote <Boolean>] [-NoInstallOnUnprotected <Boolean>]
 [-O365LanguageSelection <String[]>] [-PassThru] [-Product <String[]>] [-Required <String[]>]
 [-RequirePostRebootFullScan <Boolean>] [-RunType <RunType>] [-Schedule <IResultObject>]
 [-SendWakeupPacket <Boolean>] [-Severity <SeverityType[]>] [-SoftDeadlineEnabled <Boolean>]
 [-SuccessPercentage <Int32>] [-Superseded <Boolean>] [-SuppressRestartServer <Boolean>]
 [-SuppressRestartWorkstation <Boolean>] [-Title <String[]>] [-UpdateClassification <String[]>]
 [-UpdateDeploymentWaitDay <Int32>] [-UpdateDescription <String[]>] [-UseBranchCache <Boolean>]
 [-UserNotification <UserNotificationType>] [-UseUtc <Boolean>] [-Vendor <String[]>]
 [-VerboseLevel <VerboseLevelType>] [-WriteFilterHandling <Boolean>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByIdMandatory

Set-CMSoftwareUpdateAutoDeploymentRule [-AddToExistingSoftwareUpdateGroup <Boolean>] [-AlertTime <Int32>]
 [-AlertTimeUnit <TimeUnitType>] [-AllowRestart <Boolean>]
 [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>] [-AllowUseMeteredNetwork <Boolean>]
 [-Architecture <ArchitectureType[]>] [-ArticleId <String[]>] [-AvailableImmediately <Boolean>]
 [-AvailableTime <Int32>] [-AvailableTimeUnit <TimeUnitType>] [-BulletinId <String[]>] [-CMTag <CMTagTypes[]>]
 [-CollectionName <String>] [-ContentSize <String[]>] [-CustomSeverity <SeverityType[]>]
 [-DateReleasedOrRevised <DateReleasedOrRevisedType>] [-DeadlineImmediately <Boolean>] [-DeadlineTime <Int32>]
 [-DeadlineTimeUnit <TimeUnitType>] [-DeploymentPackage <IResultObject>] [-DeploymentPackageName <String>]
 [-DeploymentRing <DeploymentRing>] [-DeployWithoutLicense <Boolean>] [-Description <String>]
 [-DisableOperationManager <Boolean>] [-DownloadFromInternet <Boolean>]
 [-DownloadFromMicrosoftUpdate <Boolean>] [-Enable <Boolean>] [-EnabledAfterCreate <Boolean>] [-Force]
 [-GenerateFailureAlert <Boolean>] [-GenerateOperationManagerAlert <Boolean>] [-GenerateSuccessAlert <Boolean>]
 -Id <String[]> [-Language <String[]>] [-LanguageSelection <String[]>] [-Location <String>]
 [-MicrosoftAsVendor <Boolean>] [-NewName <String>] [-NoInstallOnRemote <Boolean>]
 [-NoInstallOnUnprotected <Boolean>] [-O365LanguageSelection <String[]>] [-PassThru] [-Product <String[]>]
 [-Required <String[]>] [-RequirePostRebootFullScan <Boolean>] [-RunType <RunType>] [-Schedule <IResultObject>]
 [-SendWakeupPacket <Boolean>] [-Severity <SeverityType[]>] [-SoftDeadlineEnabled <Boolean>]
 [-SuccessPercentage <Int32>] [-Superseded <Boolean>] [-SuppressRestartServer <Boolean>]
 [-SuppressRestartWorkstation <Boolean>] [-Title <String[]>] [-UpdateClassification <String[]>]
 [-UpdateDeploymentWaitDay <Int32>] [-UpdateDescription <String[]>] [-UseBranchCache <Boolean>]
 [-UserNotification <UserNotificationType>] [-UseUtc <Boolean>] [-Vendor <String[]>]
 [-VerboseLevel <VerboseLevelType>] [-WriteFilterHandling <Boolean>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByValueMandatory

Set-CMSoftwareUpdateAutoDeploymentRule [-AddToExistingSoftwareUpdateGroup <Boolean>] [-AlertTime <Int32>]
 [-AlertTimeUnit <TimeUnitType>] [-AllowRestart <Boolean>]
 [-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>] [-AllowUseMeteredNetwork <Boolean>]
 [-Architecture <ArchitectureType[]>] [-ArticleId <String[]>] [-AvailableImmediately <Boolean>]
 [-AvailableTime <Int32>] [-AvailableTimeUnit <TimeUnitType>] [-BulletinId <String[]>] [-CMTag <CMTagTypes[]>]
 [-CollectionName <String>] [-ContentSize <String[]>] [-CustomSeverity <SeverityType[]>]
 [-DateReleasedOrRevised <DateReleasedOrRevisedType>] [-DeadlineImmediately <Boolean>] [-DeadlineTime <Int32>]
 [-DeadlineTimeUnit <TimeUnitType>] [-DeploymentPackage <IResultObject>] [-DeploymentPackageName <String>]
 [-DeploymentRing <DeploymentRing>] [-DeployWithoutLicense <Boolean>] [-Description <String>]
 [-DisableOperationManager <Boolean>] [-DownloadFromInternet <Boolean>]
 [-DownloadFromMicrosoftUpdate <Boolean>] [-Enable <Boolean>] [-EnabledAfterCreate <Boolean>] [-Force]
 [-GenerateFailureAlert <Boolean>] [-GenerateOperationManagerAlert <Boolean>] [-GenerateSuccessAlert <Boolean>]
 -InputObject <IResultObject> [-Language <String[]>] [-LanguageSelection <String[]>] [-Location <String>]
 [-MicrosoftAsVendor <Boolean>] [-NewName <String>] [-NoInstallOnRemote <Boolean>]
 [-NoInstallOnUnprotected <Boolean>] [-O365LanguageSelection <String[]>] [-PassThru] [-Product <String[]>]
 [-Required <String[]>] [-RequirePostRebootFullScan <Boolean>] [-RunType <RunType>] [-Schedule <IResultObject>]
 [-SendWakeupPacket <Boolean>] [-Severity <SeverityType[]>] [-SoftDeadlineEnabled <Boolean>]
 [-SuccessPercentage <Int32>] [-Superseded <Boolean>] [-SuppressRestartServer <Boolean>]
 [-SuppressRestartWorkstation <Boolean>] [-Title <String[]>] [-UpdateClassification <String[]>]
 [-UpdateDeploymentWaitDay <Int32>] [-UpdateDescription <String[]>] [-UseBranchCache <Boolean>]
 [-UserNotification <UserNotificationType>] [-UseUtc <Boolean>] [-Vendor <String[]>]
 [-VerboseLevel <VerboseLevelType>] [-WriteFilterHandling <Boolean>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Cmdleten Set-CMSoftwareUpdateAutoDeploymentRule ändrar en regel för automatisk distribution (ADR) för programuppdateringar. Om du vill hämta en befintlig regel använder du cmdleten Get-CMSoftwareUpdateAutoDeploymentRule.

Konfigurationshanteraren använder regler för att hantera automatisk distribution av programuppdateringar. När en regel körs lägger Konfigurationshanteraren uppdateringar som är kvalificerade för regeln till en programuppdateringsgrupp. Servern Konfigurationshanteraren ned innehållsfiler och kopierar dem till distributionsplatser och uppdaterar sedan klientdatorerna.

Anteckning

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

EXAMPLES

Exempel 1: Ändra språkval och namn på en regel

Det här kommandot ändrar regeln för automatisk distribution med namnet DeploymentRule07. Den anger portugisiska (Brasilien) för Windows programuppdateringsfiler som webbplatsen hämtar. Kommandot ändrar även namnet på regeln till DeploymentRule07Revrevrev .

Set-CMSoftwareUpdateAutoDeploymentRule -Name "DeploymentRule07" -NewName "DeploymentRule07Revised" -Description "ADR downloads Portuguese (Brazil) files." -LanguageSelection "Portuguese (Brazil)"

Exempel 2: Konfigurera distributionspaketet

I följande exempel visas olika metoder för att konfigurera distributionspaketet.

Set-CMSoftwareUpdateAutoDeploymentRule -Name $ReferenceADRName -DeploymentPackageName $null
Set-CMSoftwareUpdateAutoDeploymentRule -Name $ReferenceADRName -DeploymentPackageName $packageName
Set-CMSoftwareUpdateAutoDeploymentRule -Name $ReferenceADRName -DeploymentPackage $null
Set-CMSoftwareUpdateAutoDeploymentRule -Name $ReferenceADRName -DeploymentPackage $package

Exempel 3: Ändra en ADR för flera språk

I det här exemplet ändras den alternativa adren till att använda språkkriterierna för tre språk: engelska, ungerska och kinesiska (förenklad, MENS). Det ändras också till dessa språk för att Windows och Office 365 binärfiler som ska laddas ned.

Set-CMSoftwareUpdateAutoDeploymentRule -Name "Multi-language ADR" -Language "English","Hungarian","Chinese (Simplified, PRC)" -LanguageSelection "English","Hungarian","Chinese (Simplified, PRC)" -O365LanguageSelection "English (United States)","Hungarian (Hungary)","Chinese (Simplified, PRC)"

PARAMETERS

-AddToExistingSoftwareUpdateGroup

Anger om regeln läggs till i en befintlig uppdateringsgrupp. Om det här värdet är läggs de till i en befintlig uppdateringsgrupp varje gång regeln körs och hittar $True nya uppdateringar. Om det här värdet $False är skapas en ny uppdateringsgrupp. Ange den befintliga uppdateringsgruppen eller tilldela ett namn för den nya uppdateringsgruppen med hjälp av parametern DeploymentPackageName.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AlertTime

Anger en heltalsförskjutning från en tidsgräns för uppdateringsdistribution. Regeln använder det här värdet för att ange när regeln genererar aviseringar. Ange en tidsenhet med hjälp av parametern -AlertTimeUnit.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-AlertTimeUnit

Anger en tidsenhet för parametern -AlertTime.

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

-AllowRestart

Anger om du vill tillåta att en dator startas om om uppdateringsdistributionen sker utanför en underhållsfönstret. En underhållsperiod är en angiven tidsperiod som används för datorunderhåll och uppdateringar.

  • Om det här värdet $True är Konfigurationshanteraren datorn om det behövs för att slutföra uppdateringen.
  • Om det här $False värdet Konfigurationshanteraren startar inte datorn om.
Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowSoftwareInstallationOutsideMaintenanceWindow

Anger om uppdateringsdistributionen sker även om den schemaläggs utanför en underhållsfönstret. En underhållsperiod är en angiven tidsperiod som används för datorunderhåll och uppdateringar.

  • Om det här värdet $True är Konfigurationshanteraren distribuerar uppdateringen även den schemalagda tiden faller utanför tjänstfönstret.
  • Om det här $False värdet Konfigurationshanteraren distribuerar inte uppdateringen utanför tjänstfönstret. Den väntar tills den kan distribueras i ett tjänstfönster.
Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowUseMeteredNetwork

Anger om klienter ska kunna ladda ned innehåll via en avgiftsuppladdad Internetanslutning efter tidsgränsen, 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

-Arkitektur

Från och med version 1906 använder du den här parametern för att ange arkitekturegenskapsfiltret på sidan Programuppdateringar i adr-egenskaperna.

Type: ArchitectureType[]
Parameter Sets: (All)
Aliases: Architectures
Accepted values: Arm64, Itanium, X64, X86

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

-ArticleId

Anger en matris med villkor, som strängar, för programuppdateringar. Regeln lägger till programuppdateringar som har artikel-ID:er som uppfyller angivna villkor i programuppdateringsgruppen.

Type: String[]
Parameter Sets: (All)
Aliases:

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

-AvailableImmediately

Anger om den här regeln distribuerar uppdateringar så snart uppdateringarna blir tillgängliga. Om du väljer värdet $False använder du parametrarna -AvailableTime och -AvailableTimeUnit för att ange hur lång tid efter regeln körs för att distribuera uppdateringarna.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AvailableTime

Anger en tidsperiod som ett heltal. Konfigurationshanteraren distribuerar uppdateringarna så här långt efter att regeln har körs. Ange en tidsenhet med hjälp av parametern -AvailableTimeUnit.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-AvailableTimeUnit

Anger en tidsenhet för parametern -AvailableTime.

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

-BulletinId

Anger en matris med villkor, som strängar, för programuppdateringar. Regeln lägger till programuppdateringar som har anslags-ID:er som uppfyller angivna villkor i programuppdateringsgruppen.

Type: String[]
Parameter Sets: (All)
Aliases:

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

-CMTag

Den här egenskapen är reserverad för framtida användning.

Type: CMTagTypes[]
Parameter Sets: (All)
Aliases:
Accepted values: None, UUP

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

-CollectionName

Ange ett samlingsnamn som mål för regeln för automatisk distribution.

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

-ContentSize

Använd den här parametern för att ange egenskapsfiltret innehållsstorlek (KB) på sidan Programuppdateringar i egenskaperna för den automatiska adrenen.

Type: String[]
Parameter Sets: (All)
Aliases: ContentSizes

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

-CustomSeverity

Anger en matris med anpassade allvarlighetstyper för programuppdateringar. Regeln lägger till programuppdateringar som har anpassade allvarlighetsnivåer som uppfyller angivna villkor i programuppdateringsgruppen.

Type: SeverityType[]
Parameter Sets: (All)
Aliases:
Accepted values: None, Low, Moderate, Important, Critical

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

-DateReleasedOrReviserad

Anger ett datum som har släppts eller ändrats för programuppdateringar. Regeln lägger till programuppdateringar som har ett datum som uppfyller angivna villkor i programuppdateringsgruppen.

Type: DateReleasedOrRevisedType
Parameter Sets: (All)
Aliases:
Accepted values: Any, Last1Hour, LastHour, Last2Hours, Last3Hours, Last4Hours, Last8Hours, Last12Hours, Last16Hours, Last20Hours, Last1Day, LastDay, Last2Days, Last3Days, Last4Days, Last5Days, Last6Days, Last7Days, Last14Days, Last21Days, Last28Days, LastMonth, Last1Month, Last2Months, Last3Months, Last4Months, Last5Months, Last6Months, Last7Months, Last8Months, Last9Months, Last10Months, Last11Months, Last1Year, LastYear, Last12Months

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

-DeadlineImmediately

Anger om tidsgränsen ska införas så snart regeln körs. Om du anger värdet använder du $False parametrarna -DeadlineTime och -DeadlineTimeUnit för att ange hur lång tid efter regeln körs för att ange tidsgränsen. Efter tidsgränsen installerar Konfigurationshanteraren nödvändiga uppdateringar.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-DeadlineTime

Anger en tidsperiod som ett heltal. Tidsgränsen för uppdateringar är så här lång efter att regeln har körs. Ange en tidsenhet med hjälp av parametern -DeadlineTimeUnit.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DeadlineTimeUnit

Anger en tidsenhet för parametern -DeadlineTime.

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

-DeployWithoutLicense

Anger om regeln distribuerar uppdateringar utan licenser.

  • Om du anger värdet $True , Konfigurationshanteraren alla uppdateringar för den här regeln och godkänner eventuella licensavtal.
  • Om det här värdet Konfigurationshanteraren endast uppdateringar som inte innehåller någon licens eller som $False licensavtalet har godkänts för.
Type: Boolean
Parameter Sets: (All)
Aliases:

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

-DeploymentPackage

Använd den här parametern för att ange distributionspaket för den befintliga regeln för automatisk distribution av programuppdatering. Om du inte vill kräva något paket anger du värdet till $null .

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-DeploymentPackageName

Använd den här parametern för att ange distributionspaket för den befintliga regeln för automatisk distribution av programuppdatering. Om du inte vill kräva något paket anger du värdet till $null .

Type: String
Parameter Sets: (All)
Aliases:

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

-DeploymentRing

Type: DeploymentRing
Parameter Sets: (All)
Aliases:
Accepted values: CB, Release, BusinessMainstream, Cbb, Ltsb

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

-Beskrivning

Anger en beskrivning av regeln för automatisk distribution för programuppdateringar.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableOperationManager

Anger om du vill inaktivera System Center Operations Manager aviseringar under programuppdateringar.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-DownloadFromInternet

Anger om datorer laddar ned programuppdateringar från Internet. Om du anger värdet anger du $False en alternativ plats där datorer kan hämta uppdateringar med hjälp av parametern -Location.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-DownloadFromMicrosoftUpdate

Anger om datorer laddar ned innehåll Microsoft Update om innehållet inte är tillgängligt på en prioriterad distributionsplats på en fjärrdistributionsplats.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Aktivera

Ange om regeln för automatisk distribution är aktiverad när du har skapat den.

Type: Boolean
Parameter Sets: (All)
Aliases: Enabled, EnableDeployment

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

-EnabledAfterCreate

Anger om du vill aktivera programdistribution för den associerade programuppdateringsgruppen efter att den här regeln har körs. Om det här värdet $False är distribuerar du programuppdateringsgruppen manuellt.

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

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

-Force

Kör kommandot utan att be om bekräftelse.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-GenerateFailureAlert

Om regeln misslyckas skapar du en Konfigurationshanteraren avisering.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-GenerateOperationManagerAlert

Anger om du vill Operations Manager aviseringar under en programuppdatering.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-GenerateSuccessAlert

Anger om du vill generera en avisering för lyckad distribution.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Id

Ange en matris med regler för automatisk distribution som ska konfigureras. Det här värdet är egenskapen AutoDeploymentID för ADR-objektet.

Type: String[]
Parameter Sets: SearchByIdMandatory
Aliases: AutoDeploymentId

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

-InputObject

Ange ett regelobjekt för automatisk distribution. Om du vill hämta ett ADR-objekt använder du cmdleten Get-CMSoftwareUpdateAutoDeploymentRule.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

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

-Language

Ange en strängmatris med språkkriterier för programuppdateringar. Regeln lägger till programuppdateringar som har språk som uppfyller angivna villkor i programuppdateringsgruppen.

Använd formatet för språket som det visas i -konsolen. Ett exempel:

  • English
  • Hungarian
  • Chinese (Simplified, PRC)

Formatet för strängmatrisen är: "English","Hungarian","Chinese (Simplified, PRC)"

Tips

Om du kör denna cmdlet på en dator Windows har ett lokaliserat användargränssnitt kan språknamnen vara olika. Till exempel använder den engelska versionen Windows "danska", men den danska versionen av Windows använder "Danska".

Den här parametern skriver över alla befintliga värden med de värden som du anger.

Type: String[]
Parameter Sets: (All)
Aliases: Languages, UpdateLocales, UpdateLocale

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

-LanguageSelection

Ange en strängmatris med språk. Klienter laddar ned programuppdateringar som är tillgängliga på de angivna språken och språkneutrala uppdateringar.

Använd formatet för språket som det visas i -konsolen. Ett exempel:

  • English
  • Hungarian
  • Chinese (Simplified, PRC)

Formatet för strängmatrisen är: "English","Hungarian","Chinese (Simplified, PRC)"

Tips

Om du kör denna cmdlet på en dator Windows har ett lokaliserat användargränssnitt kan språknamnen vara olika. Till exempel använder den engelska versionen Windows "danska", men den danska versionen av Windows använder "Danska".

Den här parametern skriver över alla befintliga värden med de värden som du anger.

Type: String[]
Parameter Sets: (All)
Aliases:

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

-Plats

Anger en plats i nätverket där datorer kan ladda ned programuppdateringar. För att kunna använda den här platsen anger du värdet $False för parametern -DownloadFromInternet.

Type: String
Parameter Sets: (All)
Aliases:

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

-MicrosoftAsVendor

Anger om regeln endast innehåller uppdateringar som har Microsoft som leverantör.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Name

Anger ett namn på regeln för automatisk distribution för programuppdateringar.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases:

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

-NewName

Ange ett nytt namn för den alternativa adren.

Type: String
Parameter Sets: (All)
Aliases:

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

-NoInstallOnRemote

Anger om du inte vill tillåta installation av uppdateringar på fjärrsystem.

  • Om du anger värdet , om klienten befinner sig inom en långsam eller otillförlitlig nätverksgräns, eller om klienten använder en återställningskälla för innehåll, installerar Konfigurationshanteraren inte $True programuppdateringar.
  • Om du anger värdet $False fortsätter installationen.
Type: Boolean
Parameter Sets: (All)
Aliases:

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

-NoInstallOnUnprotected

Anger om du inte vill tillåta installation av uppdateringar på oskyddade system.

  • Om du anger värdet , om programuppdateringar inte är tillgängliga på några prioriterade $True distributionsplatser, Konfigurationshanteraren inte hämta och installera programuppdateringar.
  • Om du anger värdet $False fortsätter installationen.
Type: Boolean
Parameter Sets: (All)
Aliases:

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

-O365LanguageSelection

Gäller för version 1906 och senare. Använd den här parametern för att Office 365 välja språk för klientuppdatering. Ange en strängmatris med språk. Klienter laddar ned programuppdateringar som är tillgängliga på de angivna språken och språkneutrala uppdateringar.

Använd formatet för språket som visas i -konsolen för Windows för uppdateringsspråk. Det här formatet är samma som med parametern LanguageSelection. Ett exempel:

  • English
  • Hungarian
  • Chinese (Simplified, PRC)

Formatet för strängmatrisen är: "English","Hungarian","Chinese (Simplified, PRC)"

Tips

Om du kör denna cmdlet på en dator Windows har ett lokaliserat användargränssnitt kan språknamnen vara olika. Till exempel använder den engelska versionen Windows "danska", men den danska versionen av Windows använder "Danska".

För närvarande kan du inte ange med den här parametern alla språk som är tillgängliga i Konfigurationshanteraren konsolen. Du kan t.ex. inte ange "Ireland(Ireland)" eller "Det här är Etta (NS) ".

Från och med version 2103 måste du ange ett språk med ett landsnamn. Den här ändringen justerar den här parametern med alternativen i Konfigurationshanteraren konsolen. Till exempel -O365LanguageSelection "English (United States)"

Den här parametern skriver över alla befintliga värden med de värden som du anger.

Type: String[]
Parameter Sets: (All)
Aliases:

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

-PassThru

Returnerar ett objekt som representerar det objekt som du arbetar med. Som standard genererar den här cmdleten 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

-Produkt

Anger en matris med villkor, som strängar, för programuppdateringar. Regeln lägger till programuppdateringar för produkter som uppfyller angivna villkor i programuppdateringsgruppen.

Type: String[]
Parameter Sets: (All)
Aliases: Products

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 en uppdatering i den här distributionen kräver en omstart av systemet 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

-Obligatoriskt

Anger en matris med villkor, som strängar, för programuppdateringar. Regeln lägger till programuppdateringar som identifieras av krävs och som uppfyller angivna villkor i programuppdateringsgruppen.

Type: String[]
Parameter Sets: (All)
Aliases:

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

-RunType

Ange det återkommande schemat för när platsen utvärderar den adren.

Om du anger RunTheRuleOnSchedule anger du ett schema med hjälp av parametern -Schedule.

Type: RunType
Parameter Sets: (All)
Aliases:
Accepted values: DoNotRunThisRuleAutomatically, RunTheRuleAfterAnySoftwareUpdatePointSynchronization, RunTheRuleOnSchedule

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

-Schema

Anger ett schemaobjekt för distributionen. Om du vill hämta ett schemaobjekt använder du cmdleten New-CMSchedule. Ange ett schema för den här parametern om du anger värdet RunTheRuleOnSchedule för parametern -RunType.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-SendWakeupPacket

Anger om ett aktiveringspaket ska skickas till datorer innan distributionen påbörjas.

  • Om det här värdet $True är Konfigurationshanteraren en dator från strömsparläge.
  • Om det här värdet $False är väcks inte datorer från strömsparläge.

För att datorer ska aktiveras måste du först konfigurera Wake On LAN.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Allvarlighetsgrad

Anger en matris med allvarlighetsgrad för programuppdateringar. Regeln lägger till programuppdateringar för angivna allvarlighetsgradstyper i programuppdateringsgruppen.

Type: SeverityType[]
Parameter Sets: (All)
Aliases: Severities
Accepted values: None, Low, Moderate, Important, Critical

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 en procentandel för klientefterlevnad som ett heltal från 0 till 99. Om kompatibiliteten understiger den här procentandelen Konfigurationshanteraren genererar valfria aviseringar.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Ersatt

Anger om regeln lägger till uppdateringar som ersätts av andra uppdateringar.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-SuppressRestartServer

Anger om du vill ignorera en nödvändig uppdatering för en server. Vissa programuppdateringar 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 du vill ignorera en nödvändig uppdatering för en arbetsstation. Vissa programuppdateringar 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

-Rubrik

Anger en matris med villkor, som strängar, för programuppdateringar. Regeln lägger till programuppdateringar som har titlar som uppfyller angivna villkor i programuppdateringsgruppen.

Type: String[]
Parameter Sets: (All)
Aliases: Titles

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

-UpdateClassification

Anger en matris med villkor, som strängar, för programuppdateringar. Regeln lägger till programuppdateringar som har uppdateringsklassificering som uppfyller angivna villkor i programuppdateringsgruppen.

Type: String[]
Parameter Sets: (All)
Aliases: UpdateClassifications

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

-UpdateDeploymentWaitDay

Type: Int32
Parameter Sets: (All)
Aliases: UpdateDeploymentWaitDays

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

-UpdateDescription

Anger en matris med villkor, som strängar, för programuppdateringar. Regeln lägger till programuppdateringar som har uppdateringsbeskrivningar som uppfyller angivna villkor i programuppdateringsgruppen.

Type: String[]
Parameter Sets: (All)
Aliases:

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

-UseBranchCache

Anger om du vill Windows BranchCache för den här uppdateringsdistributionen. Om du anger värdet $True delar klienter innehåll 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 du vill Coordinated Universal Time (UTC).

  • Om det här värdet $True är använder Konfigurationshanteraren UTC för den här distributionen.
  • Om det här värdet $False är använder Konfigurationshanteraren lokal tid.
Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UserNotification

Anger typ av användarmeddelande.

  • DisplayAll: Visa i Software Center och visa alla meddelanden.
  • DisplaySoftwareCenterOnly: Visas i Software Center och visar endast meddelanden om omstarter av datorn.
  • HideAll: Dölj i Software Center och alla meddelanden.
Type: UserNotificationType
Parameter Sets: (All)
Aliases:
Accepted values: DisplayAll, DisplaySoftwareCenterOnly, HideAll

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

-Leverantör

Type: String[]
Parameter Sets: (All)
Aliases: Vendors

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

-VerboseLevel

Anger den detaljnivå som du vill att klienterna ska rapportera för distributioner som skapas med den här regeln.

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 skrivfilter ska aktiveras för inbäddade enheter.

  • För värdet $True genomför enheten ändringar under en underhållsfönstret. Den här åtgärden kräver en omstart.
  • För värdet sparar $False enheten ändringar i ett överlägg och sparar dem 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

System.Object

ANTECKNINGAR

Disable-CMSoftwareUpdateAutoDeploymentRule

Enable-CMSoftwareUpdateAutoDeploymentRule

Get-CMSoftwareUpdateAutoDeploymentRule

Invoke-CMSoftwareUpdateAutoDeploymentRule

New-CMSoftwareUpdateAutoDeploymentRule

Remove-CMSoftwareUpdateAutoDeploymentRule