Disable-CMProgram
SYNOPSIS
Zakáže programy v Správce konfigurace balíčky.
SYNTAX
SearchByValue (výchozí)
Disable-CMProgram -InputObject <IResultObject> [-PassThru] [-DisableWildcardHandling] [-ForceWildcardHandling]
[-WhatIf] [-Confirm] [<CommonParameters>]
SearchByIdAndNameMandatory
Disable-CMProgram -PackageId <String> [-PassThru] -ProgramName <String> [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchByNameAndNameMandatory
Disable-CMProgram -PackageName <String> [-PassThru] -ProgramName <String> [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Rutina Disable-CMProgram zakáže jeden nebo více programů v Správce konfigurace balíčky. Programy jsou příkazy, které jsou přidružené k Správce konfigurace balíčku. Programy identifikují akce, ke kterým dojde, když klient obdrží balíček klienta. Ke stejnému balíčku můžete přidružit více programů.
Můžete zakázat program, který zabrání Správce konfigurace v klientských počítačích, kde je aktuálně inzerován. Pokud program zakážete, nástroj Správce konfigurace stále odesílá program do distribučních bodů a stále inzeruje program v klientských počítačích, ale Správce konfigurace program v klientovi nezobrazí ani nespouštěl. Toto chování je stejné, ke kterému dochází, když zakážete inzerování, ke kterému byl program přidružen.
Poznámka
Spusťte Správce konfigurace rutiny z Správce konfigurace lokality, například PS XYZ:\>
. Další informace najdete v tématu Začínáme.
EXAMPLES
Příklad 1: Zakázání programu
PS XYZ:\>Disable-CMProgram -PackageId "CM400007" -ProgramName "ProgramD02"
Tento příkaz zakáže program s názvem ProgramD02 v balíčku, který má ID CM400007.
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 za hodnoty literálových znaků. Nemůžete ho kombinovat s forceWildcardHandling.
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čuje se). Nemůžete ho kombinovat s příkazem DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Určuje vstup pro tuto rutinu. Tento parametr můžete použít, nebo můžete vstup předáte této rutině.
Type: IResultObject
Parameter Sets: SearchByValue
Aliases: Program
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-PackageId
Určuje pole ID balíčků.
Type: String
Parameter Sets: SearchByIdAndNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PackageName
Určuje pole názvů balíčků.
Type: String
Parameter Sets: SearchByNameAndNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PassThru
Přidáním tohoto parametru vrátíte objekt, který představuje položku, se kterou pracujete. Ve výchozím nastavení tato rutina nemusí generovat žádný výstup.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ProgramName
Určuje pole názvů programů.
Type: String
Parameter Sets: SearchByIdAndNameMandatory, SearchByNameAndNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespouštěl.
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.