Udostępnij za pośrednictwem

New-CMTaskSequenceDeployment

  • Artykuł

SYNOPSIS

Tworzenie wdrożenia sekwencji zadań.

SYNTAX

SearchByValueMandatory (ustawienie domyślne)

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

Polecenie cmdlet New-CMTaskSequenceDeployment tworzy wdrożenie sekwencji zadań. Wdrożenie sekwencji zadań przypisuje sekwencję zadań do kolekcji komputerów.

Uwaga

Uruchom Menedżer konfiguracji cmdlet z dysku Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.

EXAMPLES

Przykład 1: Wdrażanie sekwencji zadań z wieloma wspólnymi parametrami

W tym przykładzie są podejmowane następujące akcje:

  • Użyj polecenia cmdlet Get-CMTaskSequence, aby pobrać obiekt sekwencji zadań do wdrożenia, i zapisz go w zmiennej $DeployTS zadań
  • Zdefiniuj kolekcję jako element docelowy wdrożenia w zmiennej $DeployCollection
  • Zdefiniuj dostępny czas wdrożenia o godzinie 25 listopada 2025 r. o godzinie 20:00 w zmiennej $DeployAvailableTime
  • Zdefiniuj czas wygaśnięcia wdrożenia 25 stycznia 2026 r. o godzinie 20:00 w zmiennej $DeployExpireTime
  • Zdefiniuj termin wdrożenia 25 grudnia 2025 r. o godzinie 20:00 w zmiennej $ScheduleDateTime
  • Polecenie cmdlet New-CMSchedule umożliwia utworzenie obiektu harmonogramu dla terminu ostatecznego z dziennym harmonogramem cyklicznym.
  • Wdrażanie sekwencji zadań
$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

Jeśli włączysz alert wdrożenia, użyj tego parametru, aby określić czas dla alertu.

Type: DateTime
Parameter Sets: (All)
Aliases:

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

-AllowFallback

Zezwalaj klientom na używanie punktów dystrybucji z domyślnej grupy granic lokacji.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-AllowSharedContent

Zezwalaj klientom na używanie punktów dystrybucji z grupy granic sąsiadów.

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

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

- Dostępność

Określ, czy ta sekwencja zadań ma być dostępna dla klientów programu Menedżer konfiguracji oraz czy jest dostępna do uruchomienia podczas wdrażania systemu operacyjnego przy użyciu nośnika rozruchowego, wstępnie przygotowanego nośnika lub środowiska 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

Określ, kiedy to wdrożenie jest dostępne.

Użyj -DeadlineDateTime, aby określić, kiedy wdrożenie wygaśnie, i -Schedule, aby określić przypisanie wdrożenia lub termin .

Type: DateTime
Parameter Sets: (All)
Aliases:

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

-Collection (Kolekcja)

Określ obiekt kolekcji jako obiekt docelowy dla tego wdrożenia sekwencji zadań. Aby uzyskać ten obiekt, użyj polecenia cmdlet Get-CMCollection.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-CollectionId

Określ identyfikator kolekcji jako element docelowy dla tego wdrożenia sekwencji zadań.

Type: String
Parameter Sets: (All)
Aliases:

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

-CollectionName

Określ nazwę kolekcji jako element docelowy dla tego wdrożenia sekwencji zadań.

Type: String
Parameter Sets: (All)
Aliases:

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

-Komentarz

Określ opcjonalny komentarz dla wdrożenia sekwencji zadań.

Type: String
Parameter Sets: (All)
Aliases:

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

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

-DeadlineDateTime

Użyj tego parametru, aby określić, kiedy wdrożenie wygaśnie.

Użyj -AvailableDateTime, aby określić, kiedy wdrożenie jest dostępne, i -Schedule, aby określić przypisanie wdrożenia lub termin .

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

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

-DeployPurpose

Określ, czy to wdrożenie jest dostępne dla użytkowników do zainstalowania, czy wymagane do zainstalowania w terminie ostatecznym.

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

Określ sposób interakcji klientów z punktami dystrybucji w celu uzyskania zawartości dla sekwencji zadań. Nie wszystkie opcje są dostępne w określonych scenariuszach. Aby uzyskać więcej informacji, zobacz Wdrażanie sekwencji zadań — opcje wdrażania.

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

Ten parametr traktuje symbole wieloznaczne jako wartości znaków literału. Nie można połączyć go z forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-DistributeCollectionName

Lokacja dystrybuuje zawartość do grup punktów dystrybucji skojarzonych z tą nazwą kolekcji.

Type: String
Parameter Sets: (All)
Aliases:

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

-DistributeContent

Dodaj ten parametr, aby dystrybuować zawartość sekwencji zadań podczas tworzenia tego wdrożenia. Klienci nie mogą zainstalować sekwencji zadań, dopóki zawartość nie zostanie dystrybuowana do punktów dystrybucji, do których mogą uzyskać dostęp klienci.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-DistributionPointGroupName

Lokacja dystrybuuje zawartość do tej grupy punktów dystrybucji.

Type: String
Parameter Sets: (All)
Aliases:

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

-DistributionPointName

Lokacja dystrybuuje zawartość do tego punktu dystrybucji.

Type: String
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InputObject

Określa obiekt sekwencji zadań do wdrożenia. Aby uzyskać obiekt sekwencji zadań, użyj polecenia cmdlet 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

Zezwalaj na uruchamianie sekwencji zadań dla klientów w Internecie.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-PercentFailure

Jeśli utworzysz alert dla wdrożeń, które zakończyły się niepowodzeniem, lokacja wygeneruje alert, gdy wartość procentowa nieudanych wdrożeń będzie wyższa niż ta liczba.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-PercentSuccess

Jeśli utworzysz alert dla pomyślnych wdrożeń, lokacja wygeneruje alert, gdy wartość procentowa pomyślnych wdrożeń będzie niższa niż ta liczba.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-PersistOnWriteFilterDevice

Konfigurowanie sposobu obsługi filtru zapisu przez klienta na urządzeniach Windows Embedded.

  • $true: Zatwierdzanie zmian w terminie lub w oknie obsługi. Wymagane jest ponowne uruchomienie.
  • $false: zastosuj zawartość na nakładce i zat zatwierdzeniu później.
Type: Boolean
Parameter Sets: (All)
Aliases:

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

-RerunBehavior

Określ, czy sekwencja zadań jest ponownie uruchomiana na komputerze, jeśli wcześniej była ona uruchomiono przed zaplanowanym czasem obowiązkowym. Domyślnie sekwencja zadań jest zawsze ponownie łączona.

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

Zezwalaj użytkownikom na uruchamianie programu niezależnie od przypisań.

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

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

-Schedule

Użyj tego parametru, aby określić przypisanie wdrożenia lub termin .

Użyj -AvailableDateTime, aby określić, kiedy wdrożenie jest dostępne, i -DeadlineDateTime, aby określić, kiedy wdrożenie wygasa.

Określ tablicę obiektów harmonogramu. Obiekt schedule definiuje obowiązkowy harmonogram przypisania dla wdrożenia. Aby utworzyć obiekt harmonogramu, użyj polecenia cmdlet New-CMSchedule.

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

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

-ScheduleEvent

Określa tablicę zdarzeń, które określają, kiedy jest uruchamiane wdrożenie sekwencji zadań.

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

Wskazuje, czy należy wysłać pakiet wznawiania do komputerów przed rozpoczęciem wdrażania. Jeśli ta wartość to $True , Menedżer konfiguracji wznawianie pracy komputera po uśpieniu. Jeśli ta wartość to $False , komputer nie jest wybudzany ze uśpienia. Aby wznowić wznawianie pracy komputerów, należy najpierw 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

Wskazuje, czy okno dialogowe procesu ma być wyświetlane dla sekwencji zadań.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-SoftwareInstallation

Po osiągnięciu ostatecznego terminu instalacji ustaw ten parametr na wartość , aby umożliwić instalację sekwencji zadań $true poza oknem obsługi.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-SystemRestart

Po osiągnięciu ostatecznego terminu instalacji ustaw ten parametr na wartość , aby w razie potrzeby umożliwić ponowne uruchomienie systemu $true poza oknem obsługi.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-TaskSequencePackageId

Określ identyfikator sekwencji zadań do wdrożenia.

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

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

-UseMeteredNetwork

Wskazuje, czy zezwalać klientom mierzonego połączenia internetowego na pobieranie zawartości po upływie ostatecznego terminu instalacji, co może wiązać się z dodatkowymi kosztami.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UseUtcForAvailableSchedule

Wskazuje, czy komputery klienckie używają czasu UTC do określenia dostępności programu. Czas UTC sprawia, że sekwencja zadań jest dostępna w tym samym czasie dla wszystkich komputerów.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UseUtcForExpireSchedule

Wskazuje, czy komputery klienckie używają czasu UTC do określenia wygaśnięcia programu. Czas UTC sprawia, że sekwencja zadań jest dostępna w tym samym czasie dla wszystkich komputerów.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

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

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

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_Advertisement

UWAGI

Upewnij się, że parametry harmonogramu są odpowiednio:

  • -AvailableDateTime: określ, kiedy to wdrożenie jest dostępne.

  • -DeadlineDateTime: określ, kiedy wygasa wdrożenie.

  • -Schedule: Określ przypisanie wdrożenia lub termin .

Get-CMTaskSequenceDeployment Set-CMTaskSequenceDeployment Remove-CMTaskSequenceDeployment

Get-CMTaskSequence

Wdrażanie sekwencji zadań