Dela via


Disable-CMProgram

SYNOPSIS

Inaktiverar program i Konfigurationshanteraren paket.

SYNTAX

SearchByValue (standard)

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

Cmdleten Disable-CMProgram inaktiverar ett eller flera program i 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.

Du kan inaktivera ett program för att Konfigurationshanteraren från att köra det på klientdatorer där det för närvarande annonseras. När du inaktiverar ett program Konfigurationshanteraren fortfarande programmet till distributionsplatser och annonserar fortfarande Programmet på klientdatorer, men Konfigurationshanteraren visar eller kör inte programmet på klienten. Det här beteendet är detsamma som när du inaktiverar en annons som programmet har associerats med.

Anteckning

Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\> . Mer information finns i Komma igång.

EXAMPLES

Exempel 1: Inaktivera ett program

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

Det här kommandot inaktiverar programmet ProgramD02 i paketet som har ID CM400007.

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

-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 indata för denna cmdlet. Du kan använda den här parametern eller skicka indata till denna 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

Anger en matris med paket-ID:er.

Type: String
Parameter Sets: SearchByIdAndNameMandatory
Aliases:

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

-PackageName

Anger en matris med paketnamn.

Type: String
Parameter Sets: SearchByNameAndNameMandatory
Aliases:

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

-PassThru

Lägg till den här parametern för att returnera ett objekt som representerar det objekt som du arbetar med. Som standard genererar denna cmdlet kanske inte några utdata.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ProgramName

Anger en matris med programnamn.

Type: String
Parameter Sets: SearchByIdAndNameMandatory, SearchByNameAndNameMandatory
Aliases:

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

-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.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_Program

ANTECKNINGAR

Enable-CMProgram

Get-CMProgram

New-CMProgram

Remove-CMProgram

Set-CMProgram

Get-CMPackage