Delen via


Disable-CMProgram

SYNOPSIS

Programma's in Configuration Manager uitgeschakeld.

SYNTAX

SearchByValue (standaard)

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

Met de cmdlet Disable-CMProgram schakelt u een of meer programma's in Configuration Manager uit. 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.

U kunt een programma uitschakelen om te voorkomen dat Configuration Manager wordt uitgevoerd op clientcomputers waarop het momenteel wordt geadverteerd. Wanneer u een programma uit Configuration Manager verzendt het programma nog steeds naar distributiepunten en wordt het programma nog steeds geadverteerd op clientcomputers, maar Configuration Manager geeft het programma niet weer of wordt het niet uitgevoerd op de client. Dit gedrag is hetzelfde als wanneer u een advertentie uit te schakelen waaraan het programma is gekoppeld.

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 uitschakelen

PS XYZ:\>Disable-CMProgram -PackageId "CM400007" -ProgramName "ProgramD02"

Met deze opdracht wordt het programma met de naam ProgramD02 uitgeschakeld in het pakket met de id CM400007.

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

-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 de invoer voor deze cmdlet. U kunt deze parameter gebruiken of u kunt de invoer doorseen naar deze cmdlet.

Type: IResultObject
Parameter Sets: SearchByValue
Aliases: Program

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

-PackageId

Hiermee geeft u een matrix met pakket-ID's op.

Type: String
Parameter Sets: SearchByIdAndNameMandatory
Aliases:

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

-PackageName

Hiermee geeft u een matrix met pakketnamen.

Type: String
Parameter Sets: SearchByNameAndNameMandatory
Aliases:

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

-PassThru

Voeg deze parameter toe om een object te retourneren dat het item vertegenwoordigt waarmee u werkt. Standaard is het mogelijk dat deze cmdlet geen uitvoer genereert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ProgramName

Hiermee geeft u een matrix met programmanamen.

Type: String
Parameter Sets: SearchByIdAndNameMandatory, SearchByNameAndNameMandatory
Aliases:

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

-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

IResultObject#SMS_Program

OPMERKINGEN

Enable-CMProgram

Get-CMProgram

New-CMProgram

Remove-CMProgram

Set-CMProgram

Get-CMPackage