New-CMTaskSequenceAutoPhasedDeployment

Artykuł
08/11/2021

SYNOPSIS

To polecenie cmdlet umożliwia utworzenie wdrożenia etapowego dla sekwencji zadań przez wygenerowanie dwóch faz z tym samymi ustawieniami.

SYNTAX

SearchByValueMandatory

New-CMTaskSequenceAutoPhasedDeployment [-TaskSequence] <IResultObject> [-AddPhases <Phase[]>]
 [-BeginCondition <BeginConditionType>] [-CriteriaOption <CriteriaType>] [-CriteriaValue <Int32>]
 [-DaysAfterPreviousPhaseSuccess <Int32>] [-DeadlineUnit <TimeUnitType>] [-DeadlineValue <Int32>]
 [-FirstCollection <IResultObject>] [-FirstCollectionId <String>] [-FirstCollectionName <String>]
 [-InsertAtOrder <Int32>] [-InstallationChoice <InstallationChoiceType>] [-SecondCollection <IResultObject>]
 [-SecondCollectionId <String>] [-SecondCollectionName <String>] [-ThrottlingDays <Int32>]
 [-Description <String>] -Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
 [-Confirm] [<CommonParameters>]

SearchByIdMandatory

New-CMTaskSequenceAutoPhasedDeployment [-TaskSequenceId] <String> [-AddPhases <Phase[]>]
 [-BeginCondition <BeginConditionType>] [-CriteriaOption <CriteriaType>] [-CriteriaValue <Int32>]
 [-DaysAfterPreviousPhaseSuccess <Int32>] [-DeadlineUnit <TimeUnitType>] [-DeadlineValue <Int32>]
 [-FirstCollection <IResultObject>] [-FirstCollectionId <String>] [-FirstCollectionName <String>]
 [-InsertAtOrder <Int32>] [-InstallationChoice <InstallationChoiceType>] [-SecondCollection <IResultObject>]
 [-SecondCollectionId <String>] [-SecondCollectionName <String>] [-ThrottlingDays <Int32>]
 [-Description <String>] -Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
 [-Confirm] [<CommonParameters>]

SearchByNameMandatory

New-CMTaskSequenceAutoPhasedDeployment [-TaskSequenceName] <String> [-AddPhases <Phase[]>]
 [-BeginCondition <BeginConditionType>] [-CriteriaOption <CriteriaType>] [-CriteriaValue <Int32>]
 [-DaysAfterPreviousPhaseSuccess <Int32>] [-DeadlineUnit <TimeUnitType>] [-DeadlineValue <Int32>]
 [-FirstCollection <IResultObject>] [-FirstCollectionId <String>] [-FirstCollectionName <String>]
 [-InsertAtOrder <Int32>] [-InstallationChoice <InstallationChoiceType>] [-SecondCollection <IResultObject>]
 [-SecondCollectionId <String>] [-SecondCollectionName <String>] [-ThrottlingDays <Int32>]
 [-Description <String>] -Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf]
 [-Confirm] [<CommonParameters>]

DESCRIPTION

Począwszy od wersji 2002, użyj tego polecenia cmdlet, aby utworzyć wdrożenie etapowe dla sekwencji zadań przez wygenerowanie dwóch faz z tym samymi ustawieniami. Zachowanie tego polecenia cmdlet jest takie samo jak w kreatorze tworzenia wdrożenia etapowego w sekwencji zadań po wybraniu opcji Automatycznie utwórz domyślne wdrożenie dwufazowe.

Uwaga

Przed utworzeniem wdrożenia etapowego upewnij się, że zawartość sekwencji zadań jest dystrybuowana do punktu dystrybucji.

EXAMPLES

Przykład 1: Tworzenie wdrożenia według nazwy sekwencji zadań

Ten przykład tworzy nowe wdrożenie etapowe sekwencji zadań o nazwie myDPName dla sekwencji zadań myTaskSequenceName.

New-CMTaskSequenceAutoPhasedDeployment -TaskSequenceName "myTaskSequenceName" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

Przykład 2: Tworzenie wdrożenia według wejściowego obiektu sekwencji zadań

Ten przykład tworzy nowe wdrożenie etapowe sekwencji zadań o nazwie myPDName dla potokowego obiektu sekwencji zadań.

$myTS | New-CMTaskSequenceAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

PARAMETERS

-AddPhases

To polecenie cmdlet automatycznie tworzy dwie fazy dla określonych dwóch kolekcji. Można również dodać więcej faz za pomocą tego parametru. Określ tablicę faz. Użyj polecenia New-CMTaskSequencePhase, aby utworzyć fazy.

Type: Phase[]
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 drugiej fazy wdrażania po sukcesie pierwszej fazy:

AfterPeriod: Ten parametr jest taki sam jak następujące ustawienie na stronie Ustawienia Kreatora tworzenia wdrożenia etapowego 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 Kreatora tworzenia wdrożenia etapowego w konsoli programu : Ręczne rozpoczęcie wdrażania drugiej fazy.

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

-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 pierwszej fazy:

Compliance: ten parametr jest taki sam jak następujące ustawienie na stronie Ustawienia Kreatora tworzenia wdrożenia etapowego 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 Kreatora tworzenia wdrożenia etapowego 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 pierwszej fazy, aby rozpocząć drugą fazę. Ten parametr jest taki sam jak następujące ustawienie na stronie Ustawienia Kreatora tworzenia wdrożenia etapowego 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 Kreatora tworzenia wdrożenia etapowego 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

-Description (Opis)

Określ opis wdrożenia etapowego sekwencji zadań.

Type: String
Parameter Sets: (All)
Aliases:

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

-FirstCollection

Określ obiekt kolekcji dla pierwszej fazy.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-FirstCollectionId

Określ identyfikator kolekcji dla pierwszej fazy.

Type: String
Parameter Sets: (All)
Aliases:

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

-FirstCollectionName

Określ nazwę kolekcji dla pierwszej fazy.

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

-InsertAtOrder

Jeśli używasz AddPhases parametru, użyj tego parametru, aby określić, gdzie w kolejności faz wstawić dodatkowe fazy. Określ liczbę całkowitą z numerem zamówienia.

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
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 Kreatora tworzenia wdrożenia etapowego 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 Kreatora tworzenia wdrożenia etapowego 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

-Name

Określ nazwę wdrożenia etapowego sekwencji zadań.

Type: String
Parameter Sets: (All)
Aliases:

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

-SecondCollection

Określ obiekt kolekcji dla drugiej fazy.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-SecondCollectionId

Określ identyfikator kolekcji dla drugiej fazy.

Type: String
Parameter Sets: (All)
Aliases:

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

-SecondCollectionName

Określ nazwę kolekcji dla drugiej fazy.

Type: String
Parameter Sets: (All)
Aliases:

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

-TaskSequence

Określ obiekt sekwencji zadań.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

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

-TaskSequenceId

Określ sekwencję zadań według identyfikatora.

Type: String
Parameter Sets: SearchByIdMandatory
Aliases: TaskSequencePackageId

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

-TaskSequenceName

Określ sekwencję zadań według nazwy.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases:

Required: True
Position: 0
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 Kreatora tworzenia wdrożenia etapowego 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

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