Remove-CMDeployment
SYNOPSIS
Tar bort en distribution.
SYNTAX
SearchByValue (standard)
Remove-CMDeployment [-Force] -InputObject <IResultObject> [-DisableWildcardHandling] [-ForceWildcardHandling]
[-WhatIf] [-Confirm] [<CommonParameters>]
SearchByIdMandatory
Remove-CMDeployment -ApplicationName <String> -DeploymentId <String> [-Force] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchByNameMandatory
Remove-CMDeployment -ApplicationName <String> -CollectionName <String> [-Force] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Cmdleten Remove-CMDeployment tar bort en programdistribution från Konfigurationshanteraren.
När du tar bort en programdistribution Konfigurationshanteraren inte bort instanser av programmet som det redan har installerat. Om du vill ta bort sådana program måste du distribuera programmet till datorerna med åtgärden Avinstallera. När du har tagit bort en programdistribution, eller en resurs från en samling som du distribuerar till, visas inte programmet i Software Center.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Ta bort en programdistribution
PS XYZ:\> Remove-CMDeployment -ApplicationName "CMappD01" -CollectionName "All Users"
Det här kommandot tar Konfigurationshanteraren distribution som är associerad med programmet CMappD01 och som tillämpas på samlingen med namnet Alla användare.
Exempel 2: Skicka ett distributionsobjekt och ta bort det
PS XYZ:\> Get-CMDeployment -CollectionName "deviceCol01" -FeatureType Application | Remove-CMDeployment -Force
Det här kommandot hämtar det angivna programdistributionsobjektet för samlingen med namnet deiceCol01 och använder pipelineoperatorn för att skicka objektet till Remove-CMDeployment, vilket tar bort distributionen. Eftersom force-parametern anges uppmanas användaren inte att göra det innan distributionen tas bort.
Exempel 3: Ta bort en distribution efter dess ID
PS XYZ:\> Remove-CMDeployment -DeploymentId "{890082B6-7C16-4600-8807-7E0003BC9D99}" -ApplicationName "application01" -Force
Det här kommandot tar bort distributionen med namnet application01 med det angivna ID:t. Eftersom force-parametern anges uppmanas användaren inte att göra det innan distributionen tas bort.
PARAMETERS
-ApplicationName
Anger namnet på programmet som är associerat med distributionen.
Type: String
Parameter Sets: SearchByIdMandatory, SearchByNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Anger namnet på samlingen som är associerad med distributionen.
Type: String
Parameter Sets: SearchByNameMandatory
Aliases:
Required: True
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: False
Accept pipeline input: False
Accept wildcard characters: False
-DeploymentId
Anger ID för en distribution.
Type: String
Parameter Sets: SearchByIdMandatory
Aliases:
Required: True
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
Utför åtgärden utan ett bekräftelsemeddelande.
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 ett distributionsobjekt. Om du vill hämta ett distributionsobjekt använder du Get-CMDeployment cmdlet.
Type: IResultObject
Parameter Sets: SearchByValue
Aliases: Deployment
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
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.