Dela via


Set-CMTaskSequenceDeployment

SYNOPSIS

Konfigurera en aktivitetssekvensdistribution.

SYNTAX

SetTaskSequenceDeploymentByValueMandatory (standard)

Set-CMTaskSequenceDeployment [-AlertDateTime <DateTime>] [-AllowFallback <Boolean>]
 [-AllowSharedContent <Boolean>] [-AllowUsersRunIndependently <Boolean>] [-Comment <String>]
 [-CreateAlertOnFailure <Boolean>] [-CreateAlertOnSuccess <Boolean>] [-DeploymentAvailableDateTime <DateTime>]
 [-DeploymentExpireDateTime <DateTime>] [-DeploymentOption <DeploymentOptionType>] -InputObject <IResultObject>
 [-InternetOption <Boolean>] [-MakeAvailableTo <MakeAvailableToType>] [-PercentFailure <Int32>]
 [-PercentSuccess <Int32>] [-PersistOnWriteFilterDevice <Boolean>] [-RerunBehavior <RerunBehaviorType>]
 [-ClearSchedule] [-RemoveSchedule <IResultObject[]>] [-AddSchedule <IResultObject[]>]
 [-Schedule <IResultObject[]>] [-ClearScheduleEvent] [-RemoveScheduleEvent <ScheduleEventType[]>]
 [-AddScheduleEvent <ScheduleEventType[]>] [-ScheduleEvent <ScheduleEventType[]>] [-SendWakeupPacket <Boolean>]
 [-ShowTaskSequenceProgress <Boolean>] [-SoftwareInstallation <Boolean>] [-SystemRestart <Boolean>]
 [-UseMeteredNetwork <Boolean>] [-UseUtcForAvailableSchedule <Boolean>] [-UseUtcForExpireSchedule <Boolean>]
 [-PassThru] [-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetTaskSequenceDeploymentByDeploymentIdMandatory

Set-CMTaskSequenceDeployment [-AlertDateTime <DateTime>] [-AllowFallback <Boolean>]
 [-AllowSharedContent <Boolean>] [-AllowUsersRunIndependently <Boolean>] [-Comment <String>]
 [-CreateAlertOnFailure <Boolean>] [-CreateAlertOnSuccess <Boolean>] [-DeploymentAvailableDateTime <DateTime>]
 [-DeploymentExpireDateTime <DateTime>] [-DeploymentOption <DeploymentOptionType>] [-InternetOption <Boolean>]
 [-MakeAvailableTo <MakeAvailableToType>] [-PercentFailure <Int32>] [-PercentSuccess <Int32>]
 [-PersistOnWriteFilterDevice <Boolean>] [-RerunBehavior <RerunBehaviorType>] [-ClearSchedule]
 [-RemoveSchedule <IResultObject[]>] [-AddSchedule <IResultObject[]>] [-Schedule <IResultObject[]>]
 [-ClearScheduleEvent] [-RemoveScheduleEvent <ScheduleEventType[]>] [-AddScheduleEvent <ScheduleEventType[]>]
 [-ScheduleEvent <ScheduleEventType[]>] [-SendWakeupPacket <Boolean>] [-ShowTaskSequenceProgress <Boolean>]
 [-SoftwareInstallation <Boolean>] [-SystemRestart <Boolean>] -TaskSequenceDeploymentId <String>
 [-UseMeteredNetwork <Boolean>] [-UseUtcForAvailableSchedule <Boolean>] [-UseUtcForExpireSchedule <Boolean>]
 [-PassThru] [-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetTaskSequenceDeploymentByNameMandatory

Set-CMTaskSequenceDeployment [-AlertDateTime <DateTime>] [-AllowFallback <Boolean>]
 [-AllowSharedContent <Boolean>] [-AllowUsersRunIndependently <Boolean>] [-Comment <String>]
 [-CreateAlertOnFailure <Boolean>] [-CreateAlertOnSuccess <Boolean>] [-DeploymentAvailableDateTime <DateTime>]
 [-DeploymentExpireDateTime <DateTime>] [-DeploymentOption <DeploymentOptionType>] [-InternetOption <Boolean>]
 [-MakeAvailableTo <MakeAvailableToType>] [-PercentFailure <Int32>] [-PercentSuccess <Int32>]
 [-PersistOnWriteFilterDevice <Boolean>] [-RerunBehavior <RerunBehaviorType>] [-ClearSchedule]
 [-RemoveSchedule <IResultObject[]>] [-AddSchedule <IResultObject[]>] [-Schedule <IResultObject[]>]
 [-ClearScheduleEvent] [-RemoveScheduleEvent <ScheduleEventType[]>] [-AddScheduleEvent <ScheduleEventType[]>]
 [-ScheduleEvent <ScheduleEventType[]>] [-SendWakeupPacket <Boolean>] [-ShowTaskSequenceProgress <Boolean>]
 [-SoftwareInstallation <Boolean>] [-SystemRestart <Boolean>] -TaskSequenceName <String>
 [-UseMeteredNetwork <Boolean>] [-UseUtcForAvailableSchedule <Boolean>] [-UseUtcForExpireSchedule <Boolean>]
 [-PassThru] [-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetTaskSequenceDeploymentByIdMandatory

Set-CMTaskSequenceDeployment [-AlertDateTime <DateTime>] [-AllowFallback <Boolean>]
 [-AllowSharedContent <Boolean>] [-AllowUsersRunIndependently <Boolean>] [-Comment <String>]
 [-CreateAlertOnFailure <Boolean>] [-CreateAlertOnSuccess <Boolean>] [-DeploymentAvailableDateTime <DateTime>]
 [-DeploymentExpireDateTime <DateTime>] [-DeploymentOption <DeploymentOptionType>] [-InternetOption <Boolean>]
 [-MakeAvailableTo <MakeAvailableToType>] [-PercentFailure <Int32>] [-PercentSuccess <Int32>]
 [-PersistOnWriteFilterDevice <Boolean>] [-RerunBehavior <RerunBehaviorType>] [-ClearSchedule]
 [-RemoveSchedule <IResultObject[]>] [-AddSchedule <IResultObject[]>] [-Schedule <IResultObject[]>]
 [-ClearScheduleEvent] [-RemoveScheduleEvent <ScheduleEventType[]>] [-AddScheduleEvent <ScheduleEventType[]>]
 [-ScheduleEvent <ScheduleEventType[]>] [-SendWakeupPacket <Boolean>] [-ShowTaskSequenceProgress <Boolean>]
 [-SoftwareInstallation <Boolean>] [-SystemRestart <Boolean>] -TaskSequencePackageId <String>
 [-UseMeteredNetwork <Boolean>] [-UseUtcForAvailableSchedule <Boolean>] [-UseUtcForExpireSchedule <Boolean>]
 [-PassThru] [-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Cmdleten Set-CMTaskSequenceDeployment konfigurerar 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: Konfigurera en distribution för att visa förloppet

Det här kommandot konfigurerar aktivitetssekvensdistributionen med hjälp av aktivitetssekvensnamnet och samlingsnamnet. Den anger kommentaren och gör att klienten kan visa aktivitetssekvensförloppet.

Set-CMTaskSequenceDeployment -TaskSequenceName "Task Sequence 1333" -CollectionName "All Systems" -Comment "Task sequence test" -ShowTaskSequenceProgress $True

Exempel 2: Konfigurera om en aktivitetssekvensdistribution

Det här kommandot konfigurerar om de flesta inställningarna för en aktivitetssekvensdistribution.

Set-CMTaskSequenceDeployment -TaskSequenceName "Task Sequence 1333" -CollectionName "All Desktop and Server Clients" -Comment "Task sequence test" -SendWakeupPacket $True -UseMeteredNetwork $True -DeploymentExpireDateTime $(Get-Date) -ScheduleEvent LogOff -RerunBehavior NeverRerunDeployedProgram -AllowUsersRunIndependently $True -ShowTaskSequenceProgress $False -SoftwareInstallation $True -SystemRestart $True -PersistOnWriteFilterDevice $False -InternetOption $True -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowFallback $True -AllowSharedContent $True

PARAMETERS

-AddSchedule

Ange ett schematokenobjekt som ska läggas till i distributionen. 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

-AddScheduleEvent

Ange en av de godkända schemahändelserna som ska läggas till i distributionen.

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

-AlertDateTime

Anger en datum/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

Anger om klienter ska tillåtas att använda en återställningskälla för innehåll.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AllowSharedContent

Anger om delat innehåll ska tillåtas.

Type: Boolean
Parameter Sets: (All)
Aliases: AllowUseRemoteDistributionPoint

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AllowUsersRunIndependently

Anger om användarna ska kunna köra programmet oberoende av varandra, oavsett tilldelningsstatus.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ClearSchedule

Lägg till den här parametern för att ta bort alla scheman från distributionen.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ClearScheduleEvent

Lägg till den här parametern för att ta bort alla schemahändelser från distributionen.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Samling

Anger ett samlingsobjekt som mål för distributionen.

Type: IResultObject
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CollectionId

Anger ID för en samling som mål för distributionen.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CollectionName

Anger ett namn på en samling som ska ta emot en aktivitetssekvensdistribution.

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 aktivitetssekvensdistributionen för att beskriva den.

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

-CreateAlertOnFailure

Anger om du vill skapa en avisering vid fel.

Type: Boolean
Parameter Sets: (All)
Aliases: CreateAlertBaseOnPercentFailure

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CreateAlertOnSuccess

Anger om du vill skapa en avisering om lyckad.

Type: Boolean
Parameter Sets: (All)
Aliases: CreateAlertBaseOnPercentSuccess

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DeploymentAvailableDateTime

Anger tillgänglig datum/tid för distribution.

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DeploymentExpireDateTime

Anger att distributionen upphör att gälla.

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DeploymentOption

Anger om klienterna laddar ned allt innehåll innan aktivitetssekvensen startas eller laddar ned innehåll efter behov av aktivitetssekvensen som körs.

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

Anger ett aktivitetssekvensdistributionsobjekt. Om du vill hämta ett aktivitetssekvensobjekt använder du cmdleten Get-CMTaskSequenceDeployment.

Type: IResultObject
Parameter Sets: SetTaskSequenceDeploymentByValueMandatory
Aliases: Deployment, DeploymentSummary, TaskSequence, Advertisement

Required: True
Position: Named
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

-MakeAvailableTo

Anger om aktivitetssekvensen ska göras tillgänglig för Konfigurationshanteraren-klienter och om den ska göras tillgänglig när du distribuerar ett operativsystem med hjälp av startmedier, förinstallerade medier eller PXE.

Type: MakeAvailableToType
Parameter Sets: (All)
Aliases:
Accepted values: Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PassThru

Returnerar det aktuella arbetsobjektet. Som standard genererar denna cmdlet inga utdata.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PercentFailure

Anger en tröskelvärdesprocent för misslyckad aktivitetssekvensdistribution.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PercentSuccess

Anger en tröskelvärdesprocent för lyckad aktivitetssekvensdistribution.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PersistOnWriteFilterDevice

Anger om du vill installera en aktivitetssekvens på det tillfälliga överlägget och genomföra ändringar senare, eller spara ändringarna vid en tidsgräns för installationen eller en underhållsfönstret. Den här inställningen gäller för enheter som kör en inbäddad version Windows med ett skrivfilter.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RemoveSchedule

Ange ett schematokenobjekt som ska tas bort från distributionen. 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

-RemoveScheduleEvent

Ange en av de godkända schemahändelserna som ska tas bort från distributionen.

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

-RerunBehavior

Anger 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

-Schema

Anger en matris med CMSchedule-objekt. Ett CMSchedule-objekt definierar det obligatoriska tilldelningsschemat för en distribution. Om du vill skapa ett CMSchedule-objekt 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

Anger om du vill tillåta att programmet installeras, även om installationen sker 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

-SystemRestart

Anger om du vill tillåta att ett annonserat program startar om systemet, även om omstarten sker 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

-TaskSequenceDeploymentId

Anger ett ID för en aktivitetssekvensdistribution som ska konfigureras.

Type: String
Parameter Sets: SetTaskSequenceDeploymentByDeploymentIdMandatory
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TaskSequenceName

Anger ett namn för aktivitetssekvensen som ska distribueras.

Type: String
Parameter Sets: SetTaskSequenceDeploymentByNameMandatory
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-TaskSequencePackageId

Anger ett ID för en aktivitetssekvens som ska distribueras.

Type: String
Parameter Sets: SetTaskSequenceDeploymentByIdMandatory
Aliases:

Required: True
Position: Named
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: 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

New-CMTaskSequenceDeployment Get-CMTaskSequenceDeployment Remove-CMTaskSequenceDeployment New-CMSchedule Get-CMTaskSequence