Set-CMApplicationDeployment
SYNOPSIS
Konfigurera en programdistribution
SYNTAX
SetApplicationDeploymentByValueMandatory (standard)
Set-CMApplicationDeployment [-AllowRepairApp <Boolean>] [-AutoCloseExecutable <Boolean>]
[-AvailableDateTime <DateTime>] [-Comment <String>] [-CreateAlertBaseOnPercentFailure <Boolean>]
[-CreateAlertBaseOnPercentSuccess <Boolean>] [-DeadlineDateTime <DateTime>] [-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>] [-FailParameterValue <Int32>] -InputObject <IResultObject>
[-OverrideServiceWindow <Boolean>] [-PersistOnWriteFilterDevice <Boolean>] [-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>] [-RaiseMomAlertsOnFailure <Boolean>] [-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>] [-RequireApproval <Boolean>] [-SendWakeUpPacket <Boolean>]
[-SuccessParameterValue <Int32>] [-TimeBaseOn <TimeType>] [-UseMeteredNetwork <Boolean>]
[-UserNotification <UserNotificationType>] [-PassThru] [-Collection <IResultObject>] [-CollectionId <String>]
[-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SetApplicationDeploymentByIdMandatory
Set-CMApplicationDeployment [-AllowRepairApp <Boolean>] -ApplicationId <String>
[-AutoCloseExecutable <Boolean>] [-AvailableDateTime <DateTime>] [-Comment <String>]
[-CreateAlertBaseOnPercentFailure <Boolean>] [-CreateAlertBaseOnPercentSuccess <Boolean>]
[-DeadlineDateTime <DateTime>] [-EnableMomAlert <Boolean>] [-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>] [-OverrideServiceWindow <Boolean>] [-PersistOnWriteFilterDevice <Boolean>]
[-PostponeDateTime <DateTime>] [-PreDeploy <Boolean>] [-RaiseMomAlertsOnFailure <Boolean>]
[-RebootOutsideServiceWindow <Boolean>] [-ReplaceToastNotificationWithDialog <Boolean>]
[-RequireApproval <Boolean>] [-SendWakeUpPacket <Boolean>] [-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>] [-UseMeteredNetwork <Boolean>] [-UserNotification <UserNotificationType>] [-PassThru]
[-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SetApplicationDeploymentByNameMandatory
Set-CMApplicationDeployment [-AllowRepairApp <Boolean>] -ApplicationName <String>
[-AutoCloseExecutable <Boolean>] [-AvailableDateTime <DateTime>] [-Comment <String>]
[-CreateAlertBaseOnPercentFailure <Boolean>] [-CreateAlertBaseOnPercentSuccess <Boolean>]
[-DeadlineDateTime <DateTime>] [-EnableMomAlert <Boolean>] [-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>] [-OverrideServiceWindow <Boolean>] [-PersistOnWriteFilterDevice <Boolean>]
[-PostponeDateTime <DateTime>] [-PreDeploy <Boolean>] [-RaiseMomAlertsOnFailure <Boolean>]
[-RebootOutsideServiceWindow <Boolean>] [-ReplaceToastNotificationWithDialog <Boolean>]
[-RequireApproval <Boolean>] [-SendWakeUpPacket <Boolean>] [-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>] [-UseMeteredNetwork <Boolean>] [-UserNotification <UserNotificationType>] [-PassThru]
[-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Cmdleten Set-CMApplicationDeployment ändrar egenskaperna för en programdistribution i Konfigurationshanteraren. Mer information finns i Distribuera program med Konfigurationshanteraren.
Om du vill ange en programdistribution som ska ändras anger du samlingsnamnet och programmet. Du kan ange ett program efter namn eller ID. Du kan också använda cmdleten Get-CMApplication för att få ett program att ändra.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Ändra tillgänglighet och tidsgräns för en programdistribution
Set-CMApplicationDeployment -ApplicationName "Track System 2011" -CollectionName "All Users" -AvailableDateTime (Get-Date) -DeadlineDateTime $(Get-Date).AddDays(30)
Det här kommandot ändrar en programdistribution för ett program med namnet Track System 2011 för en samling med namnet Alla användare. Kommandot anger det aktuella datumet för när programmet är tillgängligt. Den konfigurerar också tidsgränsen för distribution i 30 dagar i framtiden.
PARAMETERS
-AllowRepairApp
Använd den här parametern för att konfigurera alternativet för reparationsprogram när du skapar en distribution för ett program.
Type: Boolean
Parameter Sets: (All)
Aliases: AllowUserRepairApplication
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ApplicationId
Anger ID för ett program.
Type: String
Parameter Sets: SetApplicationDeploymentByIdMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ApplicationName
Anger namnet på ett program.
Type: String
Parameter Sets: SetApplicationDeploymentByNameMandatory
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AvailableDateTime
Ange ett DateTime-objekt för när distributionen är tillgänglig. Hämta det här objektet med hjälp av den inbyggda cmdleten Get-Date.
Använd DeadlineDateTime för att ange distributionstilldelningen eller tidsgränsen.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-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 den samling som programmet distribueras till. Till exempel "SMS00004".
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å den samling som programmet distribueras till.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-Kommentar
Anger en valfri kommentar för distributionen.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-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
-CreateAlertBaseOnPercentFailure
Anger om du vill skapa en avisering för en procentandel av de program som inte kan distribueras. Om du vill ange procentvärdet använder du parametern FailParameterValue.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CreateAlertBaseOnPercentSuccess
Anger om du vill skapa en avisering för en procentandel av de program som distribueras. Om du vill ange procentvärdet använder du parametern SuccessParameterValue.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeadlineDateTime
Ange ett DateTime-objekt för när den här distributionen tilldelas, även kallat tidsgränsen. Hämta det här objektet med hjälp av den inbyggda cmdleten Get-Date.
Använd -AvailableDateTime för att ange när distributionen är tillgänglig.
Type: DateTime
Parameter Sets: (All)
Aliases:
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
-EnableMomAlert
Ställ in den här $true parametern på för System Center Operations Manager aktivera underhållsläget för den här distributionen.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableSoftDeadline
Ange den här parametern till $true för att aktivera fördröjd tvingande.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-FailParameterValue
Anger procentandelen misslyckade programinstallationer som orsakar en avisering.
Ange ett heltal från 1 till 100.
Om du vill aktivera den här aviseringen anger du parametern CreatAlertBaseOnPercentFailure till $True .
Type: Int32
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 konfigureras. Hämta det här objektet med cmdleten Get-CMApplicationDeployment.
Type: IResultObject
Parameter Sets: SetApplicationDeploymentByValueMandatory
Aliases: Application, DeploymentSummary, Assignment
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-OverrideServiceWindow
Anger om distributionen sker även om den schemaläggs utanför en underhållsfönstret.
En underhållsperiod är en angiven tidsperiod som används för datorunderhåll och uppdateringar.
Om det här värdet $True är Konfigurationshanteraren distribuerar programmet även om den schemalagda tiden faller utanför underhållsfönstret.
Om det här $False värdet Konfigurationshanteraren distribuerar inte programmet utanför fönstret. Den väntar tills den kan distribueras i ett tillgängligt fönster.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
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 den här cmdleten 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
-PersistOnWriteFilterDevice
Anger om skrivfilter ska aktiveras för inbäddade enheter.
För värdet $True genomför enheten ändringar under en underhållsfönstret. Den här åtgärden kräver en omstart.
För värdet sparar $False enheten ändringar i ett överlägg och sparar dem senare.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PostponeDateTime
När du anger CreateAlertBaseOnPercentSuccess till använder du den $true här parametern för att ange ett DateTime-objekt. Konfigurationshanteraren skapar en distributionsavisering när tröskelvärdet är lägre än SuccessParameterValue efter detta datum.
Hämta det här objektet med hjälp av den inbyggda cmdleten Get-Date.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PreDeploy
Anger om programmet ska distribueras i förväg till användarens primära enhet.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RaiseMomAlertsOnFailure
Anger om du vill skapa Operations Manager avisering om en klient inte kan installera programmet.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RebootOutsideServiceWindow
Anger om en dator startas om utanför en underhållsfönstret.
En underhållsperiod är en angiven tidsperiod som används för datorunderhåll och uppdateringar.
Om det här värdet $True är sker all nödvändig omstart utan hänsyn till underhåll.
Om det här värdet $False är startar inte datorn om utanför en underhållsfönstret.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ReplaceToastNotificationWithDialog
När nödvändig programvara är tillgänglig på klienten anger du den här parametern till för $true att ersätta standardmeddelanden med ett dialogfönster. Det är falskt som standard. Mer information finns i Ersätt popup-meddelanden med dialogfönster.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RequireApproval
Om du anger den här $true parametern till måste en administratör godkänna en begäran för det här programmet på enheten.
Type: Boolean
Parameter Sets: (All)
Aliases: AppRequiresApproval
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SendWakeUpPacket
Anger om ett aktiveringspaket ska skickas till datorer innan distributionen påbörjas.
Om det här värdet $True är försöker Konfigurationshanteraren att väcka en dator från strömsparläge.
Om det här värdet $False är väcks inte datorer från strömsparläge.
För att datorer ska aktiveras måste du först konfigurera Wake On LAN.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SuccessParameterValue
Anger procentandelen lyckade programinstallationer som orsakar en avisering.
Ange ett heltal mellan 0 och 99.
Om du vill aktivera den här aviseringen anger du parametern CreateAlertBaseOnPercentSuccess som $True .
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TimeBaseOn
Anger vilken tidszon som ska användas:
LocalTime: Använd lokal tid.UTC: Använd Coordinated Universal Time (UTC).
Type: TimeType
Parameter Sets: (All)
Aliases:
Accepted values: LocalTime, Utc
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseMeteredNetwork
Anger om klienter ska kunna ladda ned innehåll via en avgiftsuppladdad Internetanslutning efter tidsgränsen, vilket kan medföra extra kostnader.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UserNotification
Anger typ av användarmeddelande.
DisplayAll: Visas i Software Center och visar alla meddelanden.DisplaySoftwareCenterOnly: Visas i Software Center och visar endast meddelanden om omstarter av datorn.HideAll: Dölj i Software Center och alla meddelanden.
Type: UserNotificationType
Parameter Sets: (All)
Aliases:
Accepted values: DisplayAll, DisplaySoftwareCenterOnly, HideAll
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: False
Accept pipeline input: False
Accept wildcard characters: False
-AutoCloseExecutable
Från och med version 2107 anger du den här parametern till för $true att aktivera programdistributionsinställningen för installationsbeteenden. Använd sedan cmdleten Add-CMDeploymentTypeInstallBehavior för att lägga till en körbar fil för att kontrollera att installationen inte ska lyckas.
Ange den här parametern $false till för att inaktivera det här alternativet i följande situationer:
- När du använder cmdleten Remove-CMDeploymentTypeInstallBehavior för att ta bort alla körbara filer
- Du vill inte att distributionen ska söka efter körbara filer.
Type: Boolean
Parameter Sets: (All)
Aliases: AutoCloseExeOnInstallBehavior
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
IResultObject#SMS_ApplicationAssignment
ANTECKNINGAR
Mer information om det här returobjektet och dess egenskaper finns i SMS_ApplicationAssignment serverns WMI-klass.