Dela via


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.

Get-CMTaskSequenceDeployment Set-CMTaskSequenceDeployment Remove-CMTaskSequenceDeployment

Get-CMTaskSequence

Distribuera en aktivitetssekvens