Remove-CMProgram
SYNOPSIS
Usuwa programy z Menedżer konfiguracji pakietu.
SYNTAX
SearchByValueMandatory (ustawienie domyślne)
Remove-CMProgram [-Force] -InputObject <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling]
[-WhatIf] [-Confirm] [<CommonParameters>]
SearchByIdAndNameMandatory
Remove-CMProgram [-Force] -PackageId <String> -ProgramName <String> [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Polecenie cmdlet Remove-CMProgram usuwa co najmniej jeden program z Menedżer konfiguracji pakietu. Programy to polecenia, które są skojarzone z Menedżer konfiguracji pakietem. Programy identyfikują akcje, które występują, gdy klient odbiera pakiet klienta. Można skojarzyć wiele programów z tym samym pakietem.
Po usunięciu programu z pakietu program Menedżer konfiguracji informacje o pakiecie w bazie Menedżer konfiguracji lokacji. Menedżer konfiguracji usuwa wszystkie anonse dla tego programu z bazy danych i usuwa anonse z klientów, którzy je odebrali. Jeśli Menedżer konfiguracji program anonsowany został już uruchomiony na komputerze klienckim, program Menedżer konfiguracji nie usunie oprogramowania.
Uwaga
Uruchom Menedżer konfiguracji cmdlet z Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.
EXAMPLES
Przykład 1: usuwanie programu przy użyciu nazwy i identyfikatora
PS XYZ:\> Remove-CMProgram -PackageId "ST10000F" -ProgramName "ProgramD02"
To polecenie usuwa program o nazwie ProgramD02 z pakietu o identyfikatorze ST10000F.
Przykład 2: Usuwanie programu za pomocą zmiennej obiektu
PS XYZ:\> $Prog = Get-CMProgram -Name "ProgramD02" -PackageId "ST10000F"
PS XYZ:\> Remove-CMProgram -InputObject $Prog
Pierwsze polecenie pobiera program o nazwie ProgramD02 w pakiecie o identyfikatorze ST10000F. Polecenie zapisuje wyniki w $Prog zmiennej .
Drugie polecenie usuwa program w $Prog.
PARAMETERS
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Ten parametr traktuje symbole wieloznaczne jako wartości literału znaków. Nie można połączyć go z forceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Force
Wymusza uruchomienie polecenia bez pytania o potwierdzenie przez użytkownika.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Określa obiekt CMProgram. Aby uzyskać obiekt CMProgram, użyj 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
Określa pakiet, który zawiera program przy użyciu identyfikatora.
Type: String
Parameter Sets: SearchByIdAndNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ProgramName
Określa program w pakiecie przy użyciu nazwy.
Type: String
Parameter Sets: SearchByIdAndNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
Typowe parametry
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.