Dela via


Remove-CMSoftwareUpdateAutoDeploymentRule

SYNOPSIS

Tar Konfigurationshanteraren distributionsregler för automatiska programuppdateringar.

SYNTAX

SearchByIdMandatory (standard)

Remove-CMSoftwareUpdateAutoDeploymentRule [-Force] [-Id] <Int32> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByValueMandatory

Remove-CMSoftwareUpdateAutoDeploymentRule [-Force] [-InputObject] <IResultObject> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByNameMandatory

Remove-CMSoftwareUpdateAutoDeploymentRule [-Force] [-Name] <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Cmdleten Remove-CMSoftwareUpdateAutoDeploymentRule tar bort angivna Konfigurationshanteraren distributionsregler för automatiska programuppdateringar.

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.

Du kan ange regler för att ta bort efter ID eller efter namn, eller ange ett regelobjekt med hjälp av cmdleten Get-CMSoftwareUpdateAutoDeploymentRule. Den här cmdleten tar bort regler permanent. Du kan använda cmdleten Disable-CMSoftwareUpdateAutoDeploymentRule för att pausa en regel.

Anteckning

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

EXAMPLES

Exempel 1: Ta bort en distributionsregel efter namn

PS XYZ:\> Remove-CMSoftwareUpdateAutoDeploymentRule -Name "Weekly Driver Updates"
Remove
Are you sure you wish to remove SoftwareUpdateAutoDeploymentRule: Name="Weekly Driver Updates"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"):

Det här kommandot tar bort en regel med namnet Veckovisa drivrutinsuppdateringar. Eftersom kommandot inte innehåller force-parametern frågar cmdleten dig innan regeln tas bort.

Exempel 2: Ta bort en distributionsregel efter ID

PS XYZ:\> Remove-CMSoftwareUpdateAutoDeploymentRule -Id "16777217" -Force

Det här kommandot inaktiverar en distributionsregel som har ID:t 16777217. Det här kommandot innehåller force-parametern, så cmdleten frågar dig inte innan regeln tas bort.

Exempel 3: Ta bort en distributionsregel med hjälp av en variabel

PS XYZ:\> $CMSUADR = Get-CMSoftwareUpdateAutoDeploymentRule -Name "Weekly Driver Updates"
PS XYZ:\> Remove-CMSoftwareUpdateAutoDeploymentRule -InputObject $CMSUADR -Force

Det första kommandot hämtar en distributionsregel som har det angivna namnet och lagrar den sedan i $CMSUADR variabeln.

Det andra kommandot tar bort regeln som lagras i variabeln .

PARAMETERS

-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

-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

-Force

Tvingar kommandot att köras utan att be om användarbekrä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

-Id

Anger en matris med-ID:er för regler för automatisk distribution av programuppdateringar. Det här värdet är egenskapen AutoDeploymentID för distributionsregelobjektet.

Type: Int32
Parameter Sets: SearchByIdMandatory
Aliases: AutoDeploymentId

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

-InputObject

Anger ett regelobjekt för automatisk distribution av programuppdatering. Om du vill hämta ett distributionsregelobjekt använder du Get-CMSoftwareUpdateAutoDeploymentRule.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

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

-Name

Anger ett namn på en regel för automatisk distribution av programuppdateringar.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases:

Required: True
Position: 0
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

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