New-CMTaskSequenceDeployment
SYNOPSIS
Skapa en aktivitetssekvensdistribution.
SYNTAX
SearchByValueMandatory (standard)
New-CMTaskSequenceDeployment [-AlertDateTime <DateTime>] [-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>] [-Availability <MakeAvailableToType>] [-DeadlineDateTime <DateTime>]
[-DeploymentOption <DeploymentOptionType>] [-DeployPurpose <DeployPurposeType>] [-InputObject] <IResultObject>
[-InternetOption <Boolean>] [-PercentFailure <Int32>] [-PercentSuccess <Int32>]
[-RerunBehavior <RerunBehaviorType>] [-RunFromSoftwareCenter <Boolean>] [-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType[]>] [-ShowTaskSequenceProgress <Boolean>] [-SoftwareInstallation <Boolean>]
[-SystemRestart <Boolean>] [-UseUtcForAvailableSchedule <Boolean>] [-UseUtcForExpireSchedule <Boolean>]
[-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>]
SearchPackageByIdMandatory
New-CMTaskSequenceDeployment [-AlertDateTime <DateTime>] [-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>] [-Availability <MakeAvailableToType>] [-DeadlineDateTime <DateTime>]
[-DeploymentOption <DeploymentOptionType>] [-DeployPurpose <DeployPurposeType>] [-InternetOption <Boolean>]
[-PercentFailure <Int32>] [-PercentSuccess <Int32>] [-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>] [-Schedule <IResultObject[]>] [-ScheduleEvent <ScheduleEventType[]>]
[-ShowTaskSequenceProgress <Boolean>] [-SoftwareInstallation <Boolean>] [-SystemRestart <Boolean>]
[-TaskSequencePackageId] <String> [-UseUtcForAvailableSchedule <Boolean>] [-UseUtcForExpireSchedule <Boolean>]
[-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-CMTaskSequenceDeployment skapar en aktivitetssekvensdistribution. En aktivitetssekvensdistribution tilldelar en aktivitetssekvens till en samling datorer.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Distribuera en aktivitetssekvens med många vanliga parametrar
Det här exemplet gör följande:
- Använd cmdleten Get-CMTaskSequence för att hämta aktivitetssekvensobjektet som ska distribueras och sparar det i $DeployTS variabeln
- Definiera samlingen som mål för distributionen i variabeln $DeployCollection
- Definiera den tillgängliga distributionstiden kl. 20:00 den 25 november 2025 i variabeln $DeployAvailableTime
- Definiera förfallotiden för distributionen kl. 20:00 den 25 januari 2026 i variabeln $DeployExpireTime
- Definiera tidsgränsen för distributionen kl. 20:00 den 25 december 2025 i variabeln $ScheduleDateTime
- Använd cmdleten New-CMSchedule för att skapa ett schemaobjekt för tidsgränsen med ett dagligt återkommande schema.
- Distribuera aktivitetssekvensen
$DeployTS = Get-CMTaskSequence -TaskSequencePackageId 'PS104823'
$DeployCollection = 'PS11B7C4'
$DeployAvailableTime = [datetime]::ParseExact("20251125-200000", "yyyyMMdd-HHmmss", $null)
$DeployExpireTime = [datetime]::ParseExact("20260125-200000", "yyyyMMdd-HHmmss", $null)
$ScheduleDateTime = [datetime]::ParseExact("20251225-200000", "yyyyMMdd-HHmmss", $null)
$DeploySchedule = New-CMSchedule -DurationInterval Days -RecurInterval Days -RecurCount 1 -DurationCount 0 -Start $ScheduleDateTime
New-CMTaskSequenceDeployment -InputObject $DeployTS -DeployPurpose Required -AvailableDateTime $DeployAvailableTime -Availability Clients -RerunBehavior AlwaysRerunProgram -Schedule $DeploySchedule -CollectionId $DeployCollection -ShowTaskSequenceProgress $true -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -RunFromSoftwareCenter $true -DeadlineDateTime $DeployExpireTime
PARAMETERS
-AlertDateTime
Om du aktiverar en distributionsavisering använder du den här parametern för att ange en tid för aviseringen.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowFallback
Tillåt att klienter använder distributionsplatser från standardplatsgränsgruppen.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowSharedContent
Tillåt att klienter använder distributionsplatser från en granngränsgrupp.
Type: Boolean
Parameter Sets: (All)
Aliases: AllowUseRemoteDistributionPoint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Tillgänglighet
Ange om du vill göra den här aktivitetssekvensen tillgänglig för Konfigurationshanteraren-klienter och om den är tillgänglig för körning när du distribuerar ett operativsystem med hjälp av startmedier, förinstallerade medier eller PXE.
Type: MakeAvailableToType
Parameter Sets: (All)
Aliases: MakeAvailableTo
Accepted values: Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AvailableDateTime
Ange när den här distributionen är tillgänglig.
Använd -DeadlineDateTime för att ange när distributionen upphör att gälla och -Schedule 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 mål för den här aktivitetssekvensdistributionen. Hämta det här objektet med 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 ett samlings-ID som mål för den här aktivitetssekvensdistributionen.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Ange ett samlingsnamn som mål för den här aktivitetssekvensdistributionen.
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 aktivitetssekvensdistributionen.
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
Använd den här parametern för att ange när distributionen upphör att gälla.
Använd -AvailableDateTime för att ange när distributionen är tillgänglig och -Schedule för att ange distributionstilldelningen eller tidsgränsen.
Type: DateTime
Parameter Sets: (All)
Aliases: DeploymentExpireDateTime
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeployPurpose
Ange om den här distributionen är tillgänglig för användare att installera, eller om den måste installeras vid 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
-DeploymentOption
Ange hur klienter interagerar med distributionsplatserna för att hämta innehåll för aktivitetssekvensen. Alla alternativ är inte tillgängliga i vissa scenarier. Mer information finns i Distribuera en aktivitetssekvens – Distributionsalternativ.
Type: DeploymentOptionType
Parameter Sets: (All)
Aliases:
Accepted values: DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence, RunFromDistributionPoint
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
Webbplatsen distribuerar innehåll till de distributionsplatsgrupper 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 för att distribuera aktivitetssekvensinnehållet när du skapar den här distributionen. Klienter kan inte installera aktivitetssekvensen förrän du distribuerar innehåll till distributionsplatser som klienterna kan komma åt.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointGroupName
Platsen distribuerar innehåll till den här distributionsplatsgruppen.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointName
Platsen distribuerar innehåll till den här distributionsplatsen.
Type: String
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 aktivitetssekvensobjekt som ska distribueras. Om du vill hämta ett aktivitetssekvensobjekt använder du cmdleten Get-CMTaskSequence.
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases: TaskSequence
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-InternetOption
Tillåt att aktivitetssekvensen körs för klienter på Internet.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PercentFailure
Om du skapar en avisering för misslyckade distributioner genererar platsen en avisering när procentandelen misslyckade distributioner är högre än det här antalet.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PercentSuccess
Om du skapar en avisering för lyckade distributioner genererar platsen en avisering när procentandelen lyckade distributioner är lägre än det här antalet.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PersistOnWriteFilterDevice
Konfigurera hur klienten hanterar skrivfiltret på Windows Embedded-enheter.
$true: Genomför ändringar vid tidsgränsen eller under en underhållsfönstret. En omstart krävs.$false: Tillämpa innehåll på överlägget och genomför senare.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RerunBehavior
Ange om aktivitetssekvensen ska köras på nytt på en dator om den tidigare kördes före den schemalagda obligatoriska tiden. Som standard kör aktivitetssekvensen alltid om.
Type: RerunBehaviorType
Parameter Sets: (All)
Aliases:
Accepted values: NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RunFromSoftwareCenter
Tillåt användare att köra programmet oberoende av tilldelningar.
Type: Boolean
Parameter Sets: (All)
Aliases: AllowUsersRunIndependently
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Schema
Använd den här parametern för att ange distributionstilldelningen eller tidsgränsen.
Använd -AvailableDateTime för att ange när distributionen är tillgänglig och -DeadlineDateTime för att ange när distributionen upphör att gälla.
Ange en matris med schemaobjekt. Ett schemaobjekt definierar det obligatoriska tilldelningsschemat för en distribution. Om du vill skapa ett schemaobjekt använder du cmdleten New-CMSchedule.
Type: IResultObject[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ScheduleEvent
Anger en matris med händelser som avgör när aktivitetssekvensdistributionen körs.
Type: ScheduleEventType[]
Parameter Sets: (All)
Aliases:
Accepted values: AsSoonAsPossible, LogOn, LogOff
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 Konfigurationshanteraren 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
-ShowTaskSequenceProgress
Anger om du vill visa en processdialogruta för en aktivitetssekvens.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SoftwareInstallation
När tidsgränsen för installationen nås anger du den här parametern $true till så att aktivitetssekvensen kan installeras utanför underhållsfönstret.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SystemRestart
När tidsgränsen för installationen har nåtts anger du den här parametern $true så att systemet kan startas om vid behov utanför underhållsfönstret.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TaskSequencePackageId
Ange ID för aktivitetssekvensen som ska distribueras.
Type: String
Parameter Sets: SearchPackageByIdMandatory
Aliases: PackageId, TaskSequenceId
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseMeteredNetwork
Anger om klienter på en avgiftsuppladdad Internetanslutning ska kunna ladda ned innehåll efter installationens tidsgräns, vilket kan medföra ytterligare kostnader.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseUtcForAvailableSchedule
Anger om klientdatorer använder UTC-tid för att fastställa tillgängligheten för ett program. UTC-tid gör aktivitetssekvensen tillgänglig på samma gång för alla datorer.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseUtcForExpireSchedule
Anger om klientdatorer använder UTC-tid för att fastställa utgångsdatum för ett program. UTC-tid gör aktivitetssekvensen tillgänglig på samma gång för alla datorer.
Type: Boolean
Parameter Sets: (All)
Aliases:
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
IResultObject#SMS_Advertisement
ANTECKNINGAR
Se till att använda schemaparametrarna på rätt sätt:
-AvailableDateTime: Ange när den här distributionen är tillgänglig.
-DeadlineDateTime: Ange när distributionen upphör att gälla.
-Schema: Ange distributionstilldelningen eller tidsgränsen.
RELATED LINKS
Get-CMTaskSequenceDeployment Set-CMTaskSequenceDeployment Remove-CMTaskSequenceDeployment