Remove-CMProgram
SYNOPSIS
Tar bort program från ett Konfigurationshanteraren-paket.
SYNTAX
SearchByValueMandatory (standard)
Remove-CMProgram [-Force] -InputObject <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling]
[-WhatIf] [-Confirm] [<CommonParameters>]
SearchByIdAndNameMandatory
Remove-CMProgram [-Force] -PackageId <String> -ProgramName <String> [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Cmdleten Remove-CMProgram tar bort ett eller flera program från ett Konfigurationshanteraren paket. Program är kommandon som är associerade med ett Konfigurationshanteraren paket. Program identifierar de åtgärder som inträffar när klienten tar emot klientpaketet. Du kan associera flera program med samma paket.
När du tar bort ett program från ett Konfigurationshanteraren uppdaterar paketinformationen i Konfigurationshanteraren platsdatabasen. Konfigurationshanteraren tar bort alla annonser för det här programmet från databasen och tar bort annonserna från klienter som har tagit emot dem. Om Konfigurationshanteraren redan har kört det annonserade programmet på klientdatorn tar Konfigurationshanteraren bort programvaran.
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 ett program med hjälp av ett namn och ett ID
PS XYZ:\> Remove-CMProgram -PackageId "ST10000F" -ProgramName "ProgramD02"
Det här kommandot tar bort programmet med namnet ProgramD02 från paketet som har ID:t ST10000F.
Exempel 2: Ta bort ett program med hjälp av en objektvariabel
PS XYZ:\> $Prog = Get-CMProgram -Name "ProgramD02" -PackageId "ST10000F"
PS XYZ:\> Remove-CMProgram -InputObject $Prog
Det första kommandot hämtar programmet med namnet ProgramD02 i paketet som har ID:t ST10000F. Kommandot lagrar resultatet i variabeln $Prog.
Det andra kommandot tar bort programmet i $Prog.
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
-InputObject
Anger ett CMProgram-objekt. Om du vill hämta ett CMProgram-objekt använder du 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
Anger det paket som innehåller programmet med hjälp av ett ID.
Type: String
Parameter Sets: SearchByIdAndNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ProgramName
Anger programmet i paketet med hjälp av ett namn.
Type: String
Parameter Sets: SearchByIdAndNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-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.