Start-CMTaskSequenceDeployment
SYNOPSIS
(Inaktuell) Starta en aktivitetssekvensdistribution.
SYNTAX
SearchByValueMandatory (standard)
Start-CMTaskSequenceDeployment [-AlertDateTime <DateTime>] [-AlertDay <DateTime>] [-AlertTime <DateTime>]
[-AllowFallback <Boolean>] [-AllowSharedContent <Boolean>] [-Availability <MakeAvailableToType>]
[-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>] [-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>] [-DeploymentAvailableDay <DateTime>]
[-DeploymentAvailableTime <DateTime>] [-DeploymentExpireDateTime <DateTime>] [-DeploymentExpireDay <DateTime>]
[-DeploymentExpireTime <DateTime>] [-DeploymentOption <DeploymentOptionType>]
[-DeployPurpose <DeployPurposeType>] [-InputObject] <IResultObject> [-InternetOption <Boolean>] [-PassThru]
[-PercentFailure <Int32>] [-PercentSuccess <Int32>] [-PersistOnWriteFilterDevice <Boolean>]
[-RerunBehavior <RerunBehaviorType>] [-RunFromSoftwareCenter <Boolean>] [-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType[]>] [-SendWakeupPacket <Boolean>] [-ShowTaskSequenceProgress <Boolean>]
[-SoftwareInstallation <Boolean>] [-SystemRestart <Boolean>] [-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>] [-UseUtcForExpireSchedule <Boolean>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchPackageByIdMandatory
Start-CMTaskSequenceDeployment [-AlertDateTime <DateTime>] [-AlertDay <DateTime>] [-AlertTime <DateTime>]
[-AllowFallback <Boolean>] [-AllowSharedContent <Boolean>] [-Availability <MakeAvailableToType>]
[-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>] [-Comment <String>]
[-DeploymentAvailableDateTime <DateTime>] [-DeploymentAvailableDay <DateTime>]
[-DeploymentAvailableTime <DateTime>] [-DeploymentExpireDateTime <DateTime>] [-DeploymentExpireDay <DateTime>]
[-DeploymentExpireTime <DateTime>] [-DeploymentOption <DeploymentOptionType>]
[-DeployPurpose <DeployPurposeType>] [-InternetOption <Boolean>] [-PassThru] [-PercentFailure <Int32>]
[-PercentSuccess <Int32>] [-PersistOnWriteFilterDevice <Boolean>] [-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>] [-Schedule <IResultObject[]>] [-ScheduleEvent <ScheduleEventType[]>]
[-SendWakeupPacket <Boolean>] [-ShowTaskSequenceProgress <Boolean>] [-SoftwareInstallation <Boolean>]
[-SystemRestart <Boolean>] [-TaskSequencePackageId] <String> [-UseMeteredNetwork <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>] [-UseUtcForExpireSchedule <Boolean>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Viktigt
Den här cmdleten är inaktuell. Använd New-CMTaskSequenceDeployment i stället.
Använd den här cmdleten för att starta en aktivitetssekvensdistribution. En aktivitetssekvensdistribution tilldelar en aktivitetssekvens till en samling datorer. Mer information finns i Distribuera en aktivitetssekvens i Konfigurationshanteraren.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenhet, till exempel PS XYZ:\> . Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Starta en aktivitetssekvensdistribution med standardalternativ
Det här kommandot startar en aktivitetssekvensdistribution med hjälp av namnet på aktivitetssekvensdistributionen och namnet på en samling.
Get-CMTaskSequence -Name "Upgrade Windows 10" | Start-CMTaskSequenceDeployment -CollectionName "Collection 01"
Exempel 2: Starta en aktivitetssekvensdistribution med konfigurerade alternativ
Det här kommandot startar en aktivitetssekvensdistribution med flera konfigurerade alternativ.
Start-CMTaskSequenceDeployment -TaskSequencePackageId "XYZ00003" -CollectionName "Collection 02" -Comment "Task sequence test" -DeployPurpose Required -SendWakeUpPacket $True -UseMeteredNetwork $True -ScheduleEvent AsSoonAsPossible -RerunBehavior NeverRerunDeployedProgram -RunFromSoftwareCenter $True -ShowTaskSequenceProgress $False -SoftwareInstallation $True -SystemRestart $True -PersistOnWriteFilterDevice $False -AllowFallback $True -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowSharedContent $True -InternetOption $True
PARAMETERS
-AlertDateTime
När du konfigurerar distributionen för att skapa en avisering för lyckad distribution använder du den här parametern för att ange ett DateTime-objekt. Konfigurationshanteraren skapar en distributionsavisering när tröskelvärdet är lägre än PercentSuccess efter det här 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
-AlertDay
Den här parametern är inaktuell. Använd AlertDateTime.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AlertTime
Den här parametern är inaktuell. Använd AlertDateTime.
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 aktivitetssekvensen ska vara 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.
Om du anger Clients är standardvärdet för parametern DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence .
Om du anger ClientsMediaAndPxe MediaAndPxe , eller är MediaAndPxeHidden standardvärdet för parametern DeploymentOption DownloadContentLocallyWhenNeededByRunningTaskSequence .
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
-Samling
Ange ett samlingsobjekt som aktivitetssekvensen 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 aktivitetssekvensen ska distribueras till.
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 aktivitetssekvensen ska distribueras till.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-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: False
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
-DeploymentAvailableDateTime
Ange ett DateTime-objekt för när den här distributionen är tillgänglig. Hämta det här objektet med hjälp av den inbyggda cmdleten Get-Date.
Använd DeploymentExpireDateTime för att ange när distributionen upphör att gälla och Schema 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
-DeploymentAvailableDay
Den här parametern är inaktuell. Använd DeploymentAvailableDateTime.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeploymentAvailableTime
Den här parametern är inaktuell. Använd DeploymentAvailableDateTime.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeploymentExpireDateTime
Ange ett DateTime-objekt för när distributionen upphör att gälla. Hämta det här objektet med hjälp av den inbyggda cmdleten Get-Date.
Använd DeploymentAvailableDateTime för att ange när distributionen är tillgänglig och Schemalägg 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
-DeploymentExpireDay
Den här parametern är inaktuell. Använd DeploymentExpireDateTime.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeploymentExpireTime
Den här parametern är inaktuell. Använd DeploymentExpireDateTime.
Type: DateTime
Parameter Sets: (All)
Aliases:
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.
Om du anger Clients för parametern Tillgänglighet är standardvärdet för den här parametern DownloadAllContentLocallyBeforeStartingTaskSequence .
Om du anger ClientsMediaAndPxe MediaAndPxe , eller för MediaAndPxeHidden parametern Tillgänglighet är standardvärdet för den här parametern DownloadContentLocallyWhenNeededByRunningTaskSequence .
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
-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 aktivitetssekvensdistributionsobjekt. Om du vill hämta det här objektet använder du cmdleten Get-CMTaskSequenceDeployment.
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-InternetOption
Anger om aktivitetssekvensen körs på klienter som ansluter via Internet.
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 denna cmdlet 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
-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 igen 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
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 extra 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: 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.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
IResultObject#SMS_Advertisement
ANTECKNINGAR
RELATED LINKS
New-CMTaskSequenceDeployment Get-CMTaskSequenceDeployment Set-CMTaskSequenceDeployment Remove-CMTaskSequenceDeployment