Delen via


Remove-CMProgram

SYNOPSIS

Hiermee verwijdert u programma's uit Configuration Manager pakket.

SYNTAX

SearchByValueMandatory (standaard)

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

SearchByIdAndNameMandatory

Remove-CMProgram [-Force] -PackageId <String> -ProgramName <String> [-DisableWildcardHandling]
 [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Met de cmdlet Remove-CMProgram worden een of meer programma's uit een Configuration Manager verwijderd. Programma's zijn opdrachten die zijn gekoppeld aan een Configuration Manager pakket. Programma's identificeren de acties die optreden wanneer de client het clientpakket ontvangt. U kunt meerdere programma's aan hetzelfde pakket koppelen.

Wanneer u een programma uit een pakket verwijdert, Configuration Manager de pakketgegevens in de Configuration Manager-sitedatabase bijgewerkt. Configuration Manager verwijdert alle aankondigingen voor dit programma uit de database en verwijdert de advertenties van clients die ze hebben ontvangen. Als Configuration Manager het aangekondigde programma al op de clientcomputer heeft uitgevoerd, Configuration Manager de software niet verwijderd.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: Een programma verwijderen met behulp van een naam en een id

PS XYZ:\> Remove-CMProgram -PackageId "ST10000F" -ProgramName "ProgramD02"

Met deze opdracht verwijdert u het programma met de naam ProgramD02 uit het pakket met de id ST10000F.

Voorbeeld 2: Een programma verwijderen met behulp van een objectvariabele

PS XYZ:\> $Prog = Get-CMProgram -Name "ProgramD02" -PackageId "ST10000F"
PS XYZ:\> Remove-CMProgram -InputObject $Prog

Met de eerste opdracht wordt het programma met de naam ProgramD02 in het pakket met de id ST10000F. De opdracht slaat de resultaten op in de $Prog variabele.

Met de tweede opdracht wordt het programma in $Prog.

PARAMETERS

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

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

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Force

Dwingt de opdracht uit te voeren zonder te vragen om bevestiging van de gebruiker.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

Hiermee geeft u een CMProgram-object. Als u een CMProgram-object wilt verkrijgen, gebruikt u Get-CMProgram cmdlet .

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

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

-PackageId

Hiermee geeft u het pakket dat het programma bevat met behulp van een id.

Type: String
Parameter Sets: SearchByIdAndNameMandatory
Aliases:

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

-ProgramName

Hiermee geeft u het programma in het pakket met behulp van een naam.

Type: String
Parameter Sets: SearchByIdAndNameMandatory
Aliases:

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

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

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

OPMERKINGEN

Disable-CMProgram

Enable-CMProgram

Get-CMProgram

New-CMProgram

Set-CMProgram