Share via


New-CMTaskSequenceDeployment

SYNOPSIS

Feladatütemezési központi telepítés létrehozása.

SYNTAX

SearchByValueMandatory (alapértelmezett)

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>]

SearchPackageById Kötelező

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

A New-CMTaskSequenceDeployment parancsmag feladatütemezési központi telepítést hoz létre. A feladatütemezési központi telepítés feladatütemezést rendel számítógépek gyűjteményéhez.

Megjegyzés

Futtassa Konfigurációkezelő parancsmagokat a Konfigurációkezelő hely meghajtóról, például: PS XYZ:\> . További információ: Első lépések.

EXAMPLES

1. példa: Feladatütemezés központi telepítése számos gyakori paraméter használatával

Ez a példa a következő műveleteket teszi:

  • A Get-CMTaskSequence parancsmag használatával lekérte és menti a feladatütemezési objektumot a $DeployTS változóba
  • Definiálja a gyűjteményt az üzembe helyezés céljaként az $DeployCollection
  • Adja meg a 2025. november 25-én 20:00-kor elérhető üzembe helyezési időt az $DeployAvailableTime
  • Az üzembe helyezés lejárati idejét 2026. január 25-én 18:00-kor adja meg az $DeployExpireTime
  • Az üzembe helyezési határidő 2025. december 25-én 18:00-kor lesz meghatározva az $ScheduleDateTime
  • A New-CMSchedule parancsmaggal hozzon létre egy ütemezési objektumot a határidőre napi rendszerességgel.
  • A feladatütemezés központi telepítése
$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

Ha engedélyezi az üzembe helyezési riasztást, ezzel a paraméterrel adhatja meg a riasztás idejét.

Type: DateTime
Parameter Sets: (All)
Aliases:

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

-AllowFallback

Az alapértelmezett helyhatárcsoportból származó terjesztési pontok használatának engedélyezése az ügyfelek számára.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowSharedContent

A szomszéd határcsoportból származó terjesztési pontok használatának engedélyezése az ügyfelek számára.

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

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

-Availability (Rendelkezésre állás)

Adja meg, hogy a feladatütemezést elérhetővé tegye-e Konfigurációkezelő-ügyfelek számára, és hogy futtatható-e, amikor rendszerindító adathordozót, előtagként telepített adathordozót vagy PXE-t használ az operációs rendszer központi telepítéséhez.

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

Adja meg, hogy mikor érhető el ez a központi telepítés.

A -DeadlineDateTime beállítással adhatja meg, hogy mikor járjon le az üzembe helyezés, és -Schedule használatával adja meg a központi telepítés hozzárendelését vagy határidejét.

Type: DateTime
Parameter Sets: (All)
Aliases:

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

-Collection (Gyűjtemény)

A feladatütemezés központi telepítésének céljaként adjon meg egy gyűjteményobjektumot. Az objektum lekért használhatja a Get-CMCollection parancsmagot.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-CollectionId (Gyűjteményazonosító)

A feladatütemezés központi telepítésének céljaként adja meg a gyűjtemény azonosítóját.

Type: String
Parameter Sets: (All)
Aliases:

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

-CollectionName (Gyűjtemény neve)

A feladatütemezés központi telepítésének céljaként adja meg a gyűjtemény nevét.

Type: String
Parameter Sets: (All)
Aliases:

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

-Comment (Megjegyzés)

Adjon meg egy nem kötelező megjegyzést a feladatütemezés központi telepítéséhez.

Type: String
Parameter Sets: (All)
Aliases:

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

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-DeadlineDateTime (Határidődátumidő)

Ezzel a paraméterrel adhatja meg, hogy mikor járjon le az üzembe helyezés.

A -AvailableDateTime beállítással adhatja meg, hogy mikor érhető el a központi telepítés, a -Schedule pedig a központi telepítés hozzárendelését vagy a határidő megadását.

Type: DateTime
Parameter Sets: (All)
Aliases: DeploymentExpireDateTime

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

-DeployPurpose

Adja meg, hogy ez a központi telepítés elérhető-e a felhasználók számára a telepítéshez, vagy kötelező a határidő lejártakor telepíteni.

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 (Üzembe helyezési beállítás)

Adja meg, hogy az ügyfelek hogyan kommunikálnak a terjesztési pontokkal a feladatütemezés tartalmának lekért végrehajtásához. Bizonyos forgatókönyvekben nem minden lehetőség érhető el. További információ: Feladatütemezés központi telepítése – Telepítési beállítások.

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

Ez a paraméter literál karakterértékekként kezeli a helyettesítő karaktereket. Nem kombinálhatja a ForceWildcardHandling használatával.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-DistributeCollectionName

A hely terjeszti a tartalmat a gyűjtemény nevéhez társított terjesztésipont-csoportok között.

Type: String
Parameter Sets: (All)
Aliases:

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

-DistributeContent

Adja hozzá ezt a paramétert a feladatütemezés tartalmának terjesztéséhez a központi telepítés létrehozásakor. Az ügyfelek addig nem telepítik a feladatütemezést, amíg nem terjesztik a tartalmat olyan terjesztési pontokra, amelyekhez az ügyfelek hozzáférhetnek.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-DistributionPointGroupName

A hely tartalmat terjeszt erre a terjesztésipont-csoportra.

Type: String
Parameter Sets: (All)
Aliases:

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

-DistributionPointName (Terjesztési pont neve)

A hely erre a terjesztési pontra terjeszti a tartalmat.

Type: String
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Ez a paraméter feldolgozza a helyettesítő karaktereket, és váratlan viselkedéshez vezethet (nem ajánlott). Nem kombinálhatja a DisableWildcardHandling használatával.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

Megadja a központi telepítéshez a feladatütemezési objektumot. Feladatütemezési objektum lekért végrehajtásához használja a Get-CMTaskSequence parancsmagot.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases: TaskSequence

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-InternetOption (Internetes beállítás)

Engedélyezze a feladatütemezés futtatását az interneten található ügyfelek számára.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-PercentFailure (Százalékos lefúvatás)

Ha riasztást hoz létre a sikertelen központi telepítések esetén, a hely riasztást küld, ha a sikertelen központi telepítések százalékos aránya nagyobb ennél a számnál.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-PercentSuccess (Százalékos siker)

Ha riasztást hoz létre a sikeres központi telepítéshez, a hely riasztást hoz létre, ha a sikeres központi telepítések százalékos aránya ennél a számnál alacsonyabb.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-PersistOnWriteFilterDevice

Annak konfigurálása, hogy az ügyfél hogyan kezelje az írási szűrőt Windows Embedded-eszközökön.

  • $true: Véglegesítés a határidő lejártakor vagy karbantartási időszakban. Újraindítás szükséges.
  • $false: Tartalom alkalmazása az átfedésen, majd véglegesítés később.
Type: Boolean
Parameter Sets: (All)
Aliases:

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

-RerunBehavior

Adja meg, hogy a feladatütemezés újra fut-e a számítógépen, ha korábban már futott az ütemezett kötelező időpont előtt. Alapértelmezés szerint a feladatütemezés mindig újrafut.

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

A program hozzárendeléstől független futtatásának engedélyezése a felhasználók számára.

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

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

-Schedule (Ütemezés)

Ezzel a paraméterrel adhatja meg az üzembe helyezési hozzárendelést vagy a határidő megadását.

A -AvailableDateTime használatával adhatja meg, hogy mikor érhető el a központi telepítés, a -DeadlineDateTime pedig azt, hogy mikor járjon le a központi telepítés.

Adja meg az ütemezési objektumok tömbjét. Az ütemezési objektum határozza meg a központi telepítés kötelező hozzárendelési ütemezését. Ütemezési objektum létrehozásához használja a New-CMSchedule parancsmagot.

Type: IResultObject[]
Parameter Sets: (All)
Aliases:

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

-ScheduleEvent

Egy eseménytömböt ad meg, amely meghatározza, hogy mikor fut a feladatütemezés központi telepítése.

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

Azt jelzi, hogy a telepítés megkezdése előtt kell-e ébresztési csomagot küldeni a számítógépeknek. Ha ez az érték $True , Konfigurációkezelő felébreszti a számítógépet az alvó üzemmódból. Ha ez az érték , akkor nem ébreszti fel a $False számítógépeket az alvó üzemmódból. A számítógépek felébresztéséhez először konfigurálja a Hálózati ébresztés.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ShowTaskSequenceProgress (ShowTaskSequenceProgress)

Azt jelzi, hogy meg kell-e jelenik-e egy feladatütemezés folyamat párbeszédpanelje.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-SoftwareInstallation (Szoftvertelepítés)

A telepítési határidő elérésekor állítsa ezt a paramétert a következőre: , hogy a feladatütemezés a karbantartási időszakon kívül $true is telepíthető.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-SystemRestart (Rendszer újraindítása)

A telepítési határidő elérésekor állítsa ezt a paramétert a következőre: , hogy engedélyezze a rendszer újraindítását, $true ha szükséges, a karbantartási időszakon kívül.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-TaskSequencePackageId

Adja meg a telepíteni kívánt feladatütemezés azonosítóját.

Type: String
Parameter Sets: SearchPackageByIdMandatory
Aliases: PackageId, TaskSequenceId

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

-UseMeteredNetwork

Azt jelzi, hogy engedélyezi-e az ügyfelek számára, hogy forgalmi díjas internetkapcsolaton keresztül letöltsön-e tartalmat a telepítési határidő után, ami további költségekkel jár.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UseUtcForAvailableSchedule

Azt jelzi, hogy az ügyfélszámítógépek utc időzónában határozzák-e meg a programok rendelkezésre állását. Az UTC idő szerint a feladatütemezés ugyanakkor elérhetővé válik az összes számítógép számára.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UseUtcForExpireSchedule

Azt jelzi, hogy az ügyfélszámítógépek UTC időzónával határozzák-e meg egy program lejáratát. Az UTC idő szerint a feladatütemezés ugyanakkor elérhetővé válik az összes számítógép számára.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

Ez a parancsmag a következő általános paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction és -WarningVariable. További információ: about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_Advertisement

MEGJEGYZÉSEK

Ügyeljen arra, hogy az ütemezési paramétereket megfelelően használja:

  • -AvailableDateTime: Itt adhatja meg, hogy mikor érhető el ez a központi telepítés.

  • -DeadlineDateTime: Adja meg, hogy mikor járjon le az üzembe helyezés.

  • -Schedule: Adja meg a központi telepítés hozzárendelését vagy a határidő megadását.

Get-CMTaskSequenceDeployment Set-CMTaskSequenceDeployment Remove-CMTaskSequenceDeployment

Get-CMTaskSequence

Feladatütemezés üzembe helyezése