New-CMApplicationDeployment
SYNOPSIS
Skapa en programdistribution.
SYNTAX
SearchByValueMandatory (standard)
New-CMApplicationDeployment [-AllowRepairApp <Boolean>] [-ApprovalRequired <Boolean>]
[-AutoCloseExecutable <Boolean>] [-DeadlineDateTime <DateTime>] [-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>] [-DisableContentDependencyDetection] [-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>] [-FailParameterValue <Int32>] [-GenerateScomAlertOnFailure <Boolean>]
[-InputObject] <IResultObject> [-OverrideServiceWindow <Boolean>] [-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>] [-RebootOutsideServiceWindow <Boolean>] [-ReplaceToastNotificationWithDialog <Boolean>]
[-Simulation] [-SuccessParameterValue <Int32>] [-TimeBaseOn <TimeType>] [-UpdateSupersedence <Boolean>]
[-UserNotification <UserNotificationType>] [-DistributeCollectionName <String>] [-DistributeContent]
[-DistributionPointGroupName <String>] [-DistributionPointName <String>] [-AvailableDateTime <DateTime>]
[-Comment <String>] [-PersistOnWriteFilterDevice <Boolean>] [-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>] [-Collection <IResultObject>] [-CollectionId <String>]
[-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SearchByIdMandatory
New-CMApplicationDeployment [-AllowRepairApp <Boolean>] [-ApprovalRequired <Boolean>]
[-AutoCloseExecutable <Boolean>] [-DeadlineDateTime <DateTime>] [-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>] [-DisableContentDependencyDetection] [-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>] [-FailParameterValue <Int32>] [-GenerateScomAlertOnFailure <Boolean>]
[-Id] <Int32> [-OverrideServiceWindow <Boolean>] [-PostponeDateTime <DateTime>] [-PreDeploy <Boolean>]
[-RebootOutsideServiceWindow <Boolean>] [-ReplaceToastNotificationWithDialog <Boolean>] [-Simulation]
[-SuccessParameterValue <Int32>] [-TimeBaseOn <TimeType>] [-UpdateSupersedence <Boolean>]
[-UserNotification <UserNotificationType>] [-DistributeCollectionName <String>] [-DistributeContent]
[-DistributionPointGroupName <String>] [-DistributionPointName <String>] [-AvailableDateTime <DateTime>]
[-Comment <String>] [-PersistOnWriteFilterDevice <Boolean>] [-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>] [-Collection <IResultObject>] [-CollectionId <String>]
[-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
SearchByNameMandatory
New-CMApplicationDeployment [-AllowRepairApp <Boolean>] [-ApprovalRequired <Boolean>]
[-AutoCloseExecutable <Boolean>] [-DeadlineDateTime <DateTime>] [-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>] [-DisableContentDependencyDetection] [-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>] [-FailParameterValue <Int32>] [-GenerateScomAlertOnFailure <Boolean>]
[-Name] <String> [-OverrideServiceWindow <Boolean>] [-PostponeDateTime <DateTime>] [-PreDeploy <Boolean>]
[-RebootOutsideServiceWindow <Boolean>] [-ReplaceToastNotificationWithDialog <Boolean>] [-Simulation]
[-SuccessParameterValue <Int32>] [-TimeBaseOn <TimeType>] [-UpdateSupersedence <Boolean>]
[-UserNotification <UserNotificationType>] [-DistributeCollectionName <String>] [-DistributeContent]
[-DistributionPointGroupName <String>] [-DistributionPointName <String>] [-AvailableDateTime <DateTime>]
[-Comment <String>] [-PersistOnWriteFilterDevice <Boolean>] [-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>] [-Collection <IResultObject>] [-CollectionId <String>]
[-CollectionName <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
[<CommonParameters>]
DESCRIPTION
Cmdleten New-CMApplicationDeployment skapar en programdistribution. Mer information finns i Distribuera program med Konfigurationshanteraren.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Installera ett program
Det här kommandot skapar en ny distribution för Visual Studio 2019 till samlingen Developers Workstation. Appen installeras och krävs. Både det tillgängliga datumet och tidsgränsen är samma tid i det förflutna, så när klienten tar emot den här principen installeras appen.
New-CMApplicationDeployment -Name "Visual Studio 2019" -AvailableDateTime '01/01/2020 00:00:00' -CollectionName 'Developers Workstation' -DeadlineDateTime '01/01/2020 00:00:00' -DeployAction Install -DeployPurpose Required
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
-ApprovalRequired
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
-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:t 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
Ange en valfri kommentar för den hä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: 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: SupersedenceDeadlineDateTime
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeployAction
Ange distributionsåtgärden för att installera eller avinstallera programmet. Om konkurrerande distributioner riktar sig mot samma enhet prioriteras åtgärden Installera.
Type: DeployActionType
Parameter Sets: (All)
Aliases:
Accepted values: Install, Uninstall
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeployPurpose
Ange distributionssyfte:
Available: Användaren ser programmet i Software Center. De kan installera det på begäran.Required: Klienten installerar automatiskt appen enligt det schema som du anger. Om programmet inte är dolt kan en användare spåra dess distributionsstatus. De kan också använda Software Center för att installera programmet före tidsgränsen.
Type: DeployPurposeType
Parameter Sets: (All)
Aliases:
Accepted values: Available, Required
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableContentDependencyDetection
Lägg till den här parametern för att inte automatiskt distribuera innehåll för beroende appar.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: DisableDetectAssociatedContentDependencies
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
-DistributeCollectionName
Platsen distribuerar innehåll till de distributionsplatser som är associerade med det här samlingsnamnet.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributeContent
Lägg till den här parametern om du behöver distribuera appinnehållet först.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointGroupName
Om du vill distribuera programinnehållet anger du namnet på en distributionsplatsgrupp.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointName
Om du vill distribuera programinnehållet anger du namnet på en distributionsplats.
Type: String
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
-GenerateScomAlertOnFailure
Anger om du vill skapa Operations Manager avisering om en klient inte kan installera programmet.
Type: Boolean
Parameter Sets: (All)
Aliases: RaiseMomAlertsOnFailure
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Id
Ange ID för programmet som ska distribueras.
Type: Int32
Parameter Sets: SearchByIdMandatory
Aliases: CIId, CI_ID, ApplicationId
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Ange ett programobjekt som ska distribueras. Hämta det här objektet med cmdleten Get-CMApplication.
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases: Application
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Ange namnet på programmet som ska distribueras.
Type: String
Parameter Sets: SearchByNameMandatory
Aliases: LocalizedDisplayName, ApplicationName
Required: True
Position: 0
Default value: None
Accept pipeline input: False
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
-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 det datumet.
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
-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
-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
-Simulering
Lägg till den här parametern för att skapa en distributionssimulering. Mer information finns i Simulera programdistributioner med Konfigurationshanteraren.
Type: SwitchParameter
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
-UpdateSupersedence
För en tillgänglig distribution använder du den här parametern för att ange tidsgränsen för installation för uppgradering av användare eller enheter som har det ersatta programmet installerat. Använd DeadlineDateTime för att ange en specifik tid, annars är det så snart som möjligt efter AvailableDateTime.
Type: Boolean
Parameter Sets: (All)
Aliases:
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: None
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.