Set-CMTaskSequencePhase
SYNOPSIS
To polecenie cmdlet umożliwia skonfigurowanie fazy wdrożenia dla sekwencji zadań.
SYNTAX
SearchByPhasedDeployment
Set-CMTaskSequencePhase [-AllowFallback <Boolean>] [-AllowRemoteDP <Boolean>] [-AllowSystemRestart <Boolean>]
[-Comments <String>] [-DeploymentOption <DeploymentOptionType>] [-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>] [-UserNotification <UserNotificationType>] [-WriteFilterCommit <Boolean>]
[-BeginCondition <BeginConditionType>] [-CriteriaOption <CriteriaType>] [-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>] [-DeadlineUnit <TimeUnitType>] [-DeadlineValue <Int32>]
[-InstallationChoice <InstallationChoiceType>] [-MovePhase <ReorderType>] [-MoveToOrder <Int32>]
[-NewCollection <IResultObject>] [-NewCollectionId <String>] [-NewCollectionName <String>]
[-NewPhaseName <String>] [-ThrottlingDays <Int32>] [-Collection <IResultObject>] [-CollectionId <String>]
[-CollectionName <String>] [-Id <String>] [-InputObject] <IResultObject> [-Name <String>] [-Order <Int32>]
[-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchByPhasedDeploymentId
Set-CMTaskSequencePhase [-AllowFallback <Boolean>] [-AllowRemoteDP <Boolean>] [-AllowSystemRestart <Boolean>]
[-Comments <String>] [-DeploymentOption <DeploymentOptionType>] [-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>] [-UserNotification <UserNotificationType>] [-WriteFilterCommit <Boolean>]
[-BeginCondition <BeginConditionType>] [-CriteriaOption <CriteriaType>] [-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>] [-DeadlineUnit <TimeUnitType>] [-DeadlineValue <Int32>]
[-InstallationChoice <InstallationChoiceType>] [-MovePhase <ReorderType>] [-MoveToOrder <Int32>]
[-NewCollection <IResultObject>] [-NewCollectionId <String>] [-NewCollectionName <String>]
[-NewPhaseName <String>] [-ThrottlingDays <Int32>] [-Collection <IResultObject>] [-CollectionId <String>]
[-CollectionName <String>] [-Id <String>] [-Name <String>] [-Order <Int32>] [-PhasedDeploymentId] <String>
[-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchByPhasedDeploymentName
Set-CMTaskSequencePhase [-AllowFallback <Boolean>] [-AllowRemoteDP <Boolean>] [-AllowSystemRestart <Boolean>]
[-Comments <String>] [-DeploymentOption <DeploymentOptionType>] [-PreDownload <Boolean>]
[-SoftwareInstallation <Boolean>] [-UserNotification <UserNotificationType>] [-WriteFilterCommit <Boolean>]
[-BeginCondition <BeginConditionType>] [-CriteriaOption <CriteriaType>] [-CriteriaValue <Int32>]
[-DaysAfterPreviousPhaseSuccess <Int32>] [-DeadlineUnit <TimeUnitType>] [-DeadlineValue <Int32>]
[-InstallationChoice <InstallationChoiceType>] [-MovePhase <ReorderType>] [-MoveToOrder <Int32>]
[-NewCollection <IResultObject>] [-NewCollectionId <String>] [-NewCollectionName <String>]
[-NewPhaseName <String>] [-ThrottlingDays <Int32>] [-Collection <IResultObject>] [-CollectionId <String>]
[-CollectionName <String>] [-Id <String>] [-Name <String>] [-Order <Int32>] [-PhasedDeploymentName] <String>
[-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Dotyczy wersji 2006 i nowszych. To polecenie cmdlet umożliwia skonfigurowanie fazy wdrożenia dla sekwencji zadań. Aby uzyskać więcej informacji, zobacz Tworzenie wdrożeń etapowych.
EXAMPLES
Przykład 1: zmienianie kolekcji
Ten przykład zmienia kolekcję dla drugiej fazy wdrożenia etapowego sekwencji zadań przekazywanego w wierszu polecenia.
$phasedDeployment = Get-CMTaskSequencePhasedDeployment -Name "myPhasedDeployment"
$phasedDeployment | Set-CMTaskSequencePhase -Order 2 -NewCollectionId "XYZ00227"
Przykład 2: Przenoszenie fazy w górę
Ten przykład przenosi fazę w kolejności. Wybiera wdrożenie etapowe według jego identyfikatora i wybiera fazę według skojarzonego identyfikatora kolekcji.
Set-CMTaskSequencePhase -PhasedDeploymentId "0bc464d9-e7dd-44c1-a157-3f8be6a79c03" -CollectionId "XYZ00227" -MovePhase MoveUp
Przykład 3: Konfigurowanie ustawień fazy
Ten przykład zmienia ustawienia konfiguracji dla wybranej fazy.
Set-CMTaskSequencePhase -PhasedDeploymentName "myPhasedDeployment" -Name "phase1" -UserNotification HideAll -SoftwareInstallation $true -AllowSystemRestart $true -WriteFilterCommit $false -PreDownload $true -Comments "phase 1 comment" -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowRemoteDP $true -AllowFallback $false -CriteriaOption Compliance -CriteriaValue 90 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 3 -ThrottlingDays 5 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 12
PARAMETERS
-AllowFallback
Ten parametr jest taki sam jak następujące ustawienie na stronie Punkty dystrybucji Kreatora dodawania fazy w konsoli programu : 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
-AllowRemoteDP
Ten parametr jest taki sam jak następujące ustawienie na stronie Punkty dystrybucji Kreatora dodawania fazy w konsoli programu : Jeśli nie jest dostępny żaden lokalny punkt dystrybucji, użyj zdalnego punktu dystrybucji .
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AllowSystemRestart
Ten parametr jest taki sam jak następujące ustawienie na stronie Środowisko użytkownika Kreatora dodawania fazy w konsoli programu : Ponowne uruchomienie systemu (jeśli jest to wymagane do ukończenia instalacji). To ustawienie ma zastosowanie po osiągnięciu ostatecznego terminu instalacji, aby umożliwić to działanie 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
-BeginCondition
Określ opcję rozpoczęcia tej fazy wdrażania po sukcesie poprzedniej fazy:
AfterPeriod
: Ten parametr jest taki sam jak następujące ustawienie na stronie Faza Ustawienia Kreatora dodawania fazy w konsoli programu : Automatycznie rozpocznij tę fazę po okresie odroczenia (w dniach). Jeśli określisz tę wartość, skonfiguruj okres czasu za pomocą właściwości DaysAfterPreviousPhaseSuccess.Manually
: ten parametr jest taki sam jak następujące ustawienie na stronie Ustawienia w Kreatorze dodawania fazy w konsoli programu : Ręcznie rozpocznij tę fazę wdrażania.
Type: BeginConditionType
Parameter Sets: (All)
Aliases:
Accepted values: AfterPeriod, Manually
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Collection (Kolekcja)
Określanie obiektu dla kolekcji docelowej
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Określ kolekcję docelową według identyfikatora.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionName
Określ kolekcję docelową według nazwy.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- Komentarze
Określ opcjonalne komentarze dla tej fazy. Maksymalna długość wynosi 512 znaków.
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
-CriteriaOption
Określ opcję wyboru kryteriów powodzenia poprzedniej fazy:
Compliance
: ten parametr jest taki sam jak następujące ustawienie na stronie Ustawienia fazy w Kreatorze dodawania fazy w konsoli programu : Procent powodzenia wdrożenia. Określ wartość procentową za pomocą parametru CriteriaValue.Number
: ten parametr jest taki sam jak następujące ustawienie na stronie Ustawienia fazy w Kreatorze dodawania fazy w konsoli programu : Liczba pomyślnie wdrożonych urządzeń. Określ liczbę urządzeń za pomocą parametru CriteriaValue.
Type: CriteriaType
Parameter Sets: (All)
Aliases:
Accepted values: Compliance, Number
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CriteriaValue
Ta wartość całkowita zależy od wartości owej, która jest określana dla ustawienia CriteriaOption:
Compliance
: określ wartość procentowąNumber
: określ liczbę urządzeń
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DaysAfterPreviousPhaseSuccess
Określ wartość całkowitą dla liczby dni po sukcesie poprzedniej fazy, aby rozpocząć tę fazę. Ten parametr jest taki sam jak następujące ustawienie na stronie faza Ustawienia Kreatora dodawania fazy w konsoli programu : Automatycznie rozpocznij tę fazę po okresie odroczenia (w dniach).
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeadlineUnit
Określ typ terminu ostatecznego. Użyj tego parametru z wartością DeadlineValue.
Type: TimeUnitType
Parameter Sets: (All)
Aliases:
Accepted values: Hours, Days, Weeks, Months
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeadlineValue
Ten parametr jest używany tylko w przypadku określenia AfterPeriod
parametru InstallationChoice.
Określ wartość całkowitą dla okresu ostatecznego. Użyj parametru DeadlineUnit, aby określić typ okresu: Hours
, , , Days
Weeks
Months
. Ten parametr jest taki sam jak następujące ustawienie na stronie Ustawienia w Kreatorze dodawania fazy w konsoli programu : Instalacja jest wymagana po upływie tego czasu.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeploymentOption
Ten parametr jest taki sam jak następujące ustawienie na stronie Punkty dystrybucji Kreatora dodawania fazy w konsoli programu : wybierz opcję wdrożenia, która ma być używana, gdy klient korzysta z punktu dystrybucji z grupy granic sąsiada lub domyślnej grupy granic lokacji. Akceptuje następujące wartości:
DownloadContentLocallyWhenNeededByRunningTaskSequence
: pobieranie zawartości lokalnie w razie potrzeby przez uruchamianą sekwencję zadańDownloadAllContentLocallyBeforeStartingTaskSequence
: pobranie całej zawartości lokalnie przed uruchomieniem sekwencji zadań
Type: DeploymentOptionType
Parameter Sets: (All)
Aliases:
Accepted values: DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence
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
-ForceWildcardHandling
Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania. Nie jest to 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
-Id (Identyfikator)
Określ identyfikator fazy do skonfigurowania.
Type: String
Parameter Sets: (All)
Aliases: PhaseId
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Określ obiekt wdrożenia etapowego, który zawiera fazę do skonfigurowania.
Type: IResultObject
Parameter Sets: SearchByPhasedDeployment
Aliases: PhasedDeployment
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-InstallationChoice
Określ opcję zachowania w odniesieniu do tego, kiedy oprogramowanie zostanie udostępnione:
AsSoonAsPossible
: ten parametr jest taki sam jak następujące ustawienie na stronie Ustawienia w Kreatorze dodawania fazy w konsoli programu : Instalacja jest wymagana tak szybko, jak to możliwe.AfterPeriod
: Ten parametr jest taki sam jak następujące ustawienie na stronie Ustawienia fazy w Kreatorze dodawania fazy w konsoli programu : Instalacja jest wymagana po upływie tego czasu. Jeśli określisz tę wartość, skonfiguruj okres czasu za pomocą funkcji DeadlineUnit i DeadlineValue.
Type: InstallationChoiceType
Parameter Sets: (All)
Aliases:
Accepted values: AsSoonAsPossible, AfterPeriod
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MovePhase
Zmień kolejność dla wybranej fazy. Możesz przenieść go w górę, przenieść w dół lub przejść do określonego indeksu. Jeśli MoveToOrder
określisz parametr , użyj parametru -MoveToOrder, aby ustawić określony indeks.
Type: ReorderType
Parameter Sets: (All)
Aliases:
Accepted values: MoveUp, MoveDown, MoveToOrder
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MoveToOrder
W przypadku ustawienia parametru -MovePhase na wartość użyj tego MoveToOrder
parametru, aby ustawić określony indeks.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Name
Określ nazwę fazy do skonfigurowania.
Type: String
Parameter Sets: (All)
Aliases: PhaseName
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewCollection
Określ obiekt kolekcji do użycia jako nowy obiekt docelowy dla wybranej fazy.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewCollectionId
Określ kolekcję według identyfikatora do użycia jako nowy element docelowy dla wybranej fazy.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewCollectionName
Określ kolekcję według nazwy, która ma być nowym elementem docelowym dla wybranej fazy.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NewPhaseName
Użyj tego parametru, aby zmienić nazwę wybranej fazy.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Order (Kolejność)
Określ indeks fazy do skonfigurowania.
Type: Int32
Parameter Sets: (All)
Aliases: PhaseOrder
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PhasedDeploymentId
Wybierz wdrożenie etapowe według identyfikatora. Następnie użyj innych parametrów, aby wybrać określoną fazę w danym wdrożeniu.
Type: String
Parameter Sets: SearchByPhasedDeploymentId
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PhasedDeploymentName
Wybierz wdrożenie etapowe według nazwy. Następnie użyj innych parametrów, aby wybrać określoną fazę w danym wdrożeniu.
Type: String
Parameter Sets: SearchByPhasedDeploymentName
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PreDownload
Ten parametr jest taki sam jak następujące ustawienie na stronie Ogólne Kreatora dodawania fazy w konsoli programu : Wstępne pobieranie zawartości dla tej sekwencji zadań.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SoftwareInstallation
Ten parametr jest taki sam jak następujące ustawienie na stronie Środowisko użytkownika Kreatora dodawania fazy w konsoli programu : Instalacja oprogramowania. To ustawienie ma zastosowanie po osiągnięciu ostatecznego terminu instalacji, aby umożliwić to działanie 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
-ThrottlingDays
Określ liczbę całkowitą dla liczby dni, przez które będzie stopniowo udostępniane to oprogramowanie. Ten parametr jest taki sam jak następujące ustawienie na stronie Ustawienia fazy Kreatora dodawania fazy w konsoli programu : Stopniowo udostępnij to oprogramowanie w tym okresie (w dniach).
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UserNotification
Ten parametr jest taki sam jak następujące ustawienie na stronie Środowisko użytkownika Kreatora dodawania fazy w konsoli programu : Określ ustawienie obsługi użytkownika dla tego wdrożenia z następującymi wartościami:
DisplayAll
: wyświetlanie w Centrum oprogramowania i wyświetlanie wszystkich powiadomieńHideAll
: ukryj w Centrum oprogramowania i wszystkie powiadomienia
Type: UserNotificationType
Parameter Sets: (All)
Aliases:
Accepted values: DisplayAll, HideAll
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
-WriteFilterCommit
Ten parametr jest taki sam jak następujące ustawienie na stronie Środowisko użytkownika Kreatora dodawania fazy w konsoli programu : Zatwierdzanie zmian po upływie terminu lub w oknie obsługi (wymaga ponownego uruchomienia). To ustawienie dotyczy obsługi filtru zapisu dla urządzeń z systemem Windows Embedded.
Type: Boolean
Parameter Sets: (All)
Aliases:
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_PhasedDeployment
UWAGI
RELATED LINKS
Get-CMTaskSequencePhasedDeployment
New-CMTaskSequenceAutoPhasedDeployment
New-CMTaskSequenceManualPhasedDeployment
Remove-CMTaskSequencePhasedDeployment