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.
RELATED LINKS
Get-CMTaskSequenceDeployment Set-CMTaskSequenceDeployment Remove-CMTaskSequenceDeployment