Dela via


Remove-CMApplicationDeployment

SYNOPSIS

Ta bort en programdistribution.

SYNTAX

SearchByValue (standard)

Remove-CMApplicationDeployment -InputObject <IResultObject> [-Force] [-Collection <IResultObject>]
 [-CollectionId <String>] [-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByDeploymentId

Remove-CMApplicationDeployment [-DeploymentId <String>] [-Force] [-Collection <IResultObject>]
 [-CollectionId <String>] [-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByName

Remove-CMApplicationDeployment [-Name <String>] [-Force] [-Collection <IResultObject>] [-CollectionId <String>]
 [-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

SearchBySmsObjectId

Remove-CMApplicationDeployment [-SmsObjectId <Int32>] [-Force] [-Collection <IResultObject>]
 [-CollectionId <String>] [-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Använd den här cmdleten för att ta bort en programdistribution.

Anteckning

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

EXAMPLES

Exempel 1

Det här exemplet tar bort distributionen av appen Central till samlingen Alla HR-enheter.

Remove-CMApplicationDeployment -Name 'Central app' -CollectionName 'All HR devices'

PARAMETERS

-Samling

Ange ett samlingsobjekt som programmet ska distribueras till. Hämta det här objektet med hjälp av cmdleten Get-CMCollection.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-CollectionId

Ange ID för samlingen som programmet distribueras till. Det här värdet är ett standardinsamlings-ID, till exempel XYZ00034 .

Type: String
Parameter Sets: (All)
Aliases:

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

-CollectionName

Ange namnet på samlingen som samlingen ska distribueras till.

Type: String
Parameter Sets: (All)
Aliases:

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

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-DeploymentId

Ange det distributions-ID som ska tas bort. Det här värdet är ett GUID. Det är värdet distributions-ID i -konsolen och egenskapen AssignmentUniqueID för den SMS_ApplicationAssignment WMI-klassen.

Type: String
Parameter Sets: SearchByDeploymentId
Aliases: AssignmentUniqueID, ApplicationDeploymentID

Required: False
Position: Named
Default value: None
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

-Force

Kör kommandot utan att be om bekräftelse.

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

Ange ett programdistributionsobjekt som ska tas bort. Hämta det här objektet med cmdleten Get-CMApplicationDeployment.

Type: IResultObject
Parameter Sets: SearchByValue
Aliases: Assignment, ApplicationDeployment, Application

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

-Name

Ange namnet på det program som distribueras.

Type: String
Parameter Sets: SearchByName
Aliases: ApplicationName

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

-SmsObjectId

Ange CI_ID för programmet som distribueras. Det här värdet är det unika CI-ID:t i -konsolen, AssignedCI_UniqueID-egenskapen för SMS_ApplicationAssignment WMI-klassen och CI_UniqueID-egenskapen för SMS_Application WMI-klassen. Formatet är till exempel ScopeId_0D7D8B60-F2F9-484A-B9F3-4A8B68D14D59/Application_70659c7c-694b-4563-965f-d82537a1de1b/2 som .

Type: Int32
Parameter Sets: SearchBySmsObjectId
Aliases: CI_ID, ApplicationID

Required: False
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: None
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

System.Object

ANTECKNINGAR

Get-CMApplicationDeployment

New-CMApplicationDeployment

Set-CMApplicationDeployment