Remove-CMProgram
SYNOPSIS
Odebere programy z Configuration Manager balíčku.
SYNTAX
SearchByValueMandatory (výchozí)
Remove-CMProgram [-Force] -InputObject <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling]
[-WhatIf] [-Confirm] [<CommonParameters>]
SearchByIdAndNameMandatory
Remove-CMProgram [-Force] -PackageId <String> -ProgramName <String> [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Rutina Remove-CMProgram odebere z balíčku Configuration Manager jeden nebo více programů. Programy jsou příkazy, které jsou přidruženy k balíčku Configuration Manager. Programy identifikují akce, ke kterým dojde, když klient obdrží balíček klienta. Ke stejnému balíčku můžete přidružit několik programů.
Když odeberete program z balíčku, Configuration Manager aktualizuje informace balíčku v databázi Configuration Manager lokality. Configuration Manager odebere z databáze všechny reklamy pro tento program a odebere oznámení od klientů, kteří je přijali. Pokud Configuration Manager již inzerovaný program na klientském počítači spustil, Configuration Manager software neodebere.
Poznámka
Použijte například rutiny Configuration Manager z Configuration Manager jednotky webu PS XYZ:\> . Další informace najdete v tématu Začínáme.
EXAMPLES
Příklad 1: odebrání programu pomocí názvu a ID
PS XYZ:\> Remove-CMProgram -PackageId "ST10000F" -ProgramName "ProgramD02"
Tento příkaz odebere program s názvem ProgramD02 z balíčku s ID ST10000F.
Příklad 2: odebrání programu pomocí proměnné objektu
PS XYZ:\> $Prog = Get-CMProgram -Name "ProgramD02" -PackageId "ST10000F"
PS XYZ:\> Remove-CMProgram -InputObject $Prog
První příkaz načte do balíčku program s názvem ProgramD02, který má ID ST10000F. Příkaz uloží výsledky do proměnné $Prog.
Druhý příkaz odebere program v $Prog.
PARAMETERS
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Tento parametr považuje zástupné znaky jako literálové hodnoty znaků. Nejde kombinovat s ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Force
Vynutí spuštění příkazu bez žádosti o potvrzení uživatele.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Tento parametr zpracovává zástupné znaky a může vést k neočekávanému chování (nedoporučujeme). Nejde kombinovat s DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
– Položky InputObject
Určuje objekt CMProgram . Chcete-li získat objekt CMProgram , použijte rutinu Get-CMProgram.
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
– PackageId
Určuje balíček, který obsahuje program s použitím ID.
Type: String
Parameter Sets: SearchByIdAndNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Program
Určuje program v rámci balíčku pomocí názvu.
Type: String
Parameter Sets: SearchByIdAndNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespustí.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Tato rutina podporuje společné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v tématu about_CommonParameters.