Udostępnij za pośrednictwem

New-CMSoftwareUpdateAutoPhasedDeployment

  • Artykuł

SYNOPSIS

To polecenie cmdlet umożliwia utworzenie etapowego wdrożenia aktualizacji oprogramowania przez wygenerowanie dwóch faz z tym samymi ustawieniami.

SYNTAX

SearchByGroupMandatory

New-CMSoftwareUpdateAutoPhasedDeployment [-SoftwareUpdateGroup] <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>]

SearchByGroupIdMandatory

New-CMSoftwareUpdateAutoPhasedDeployment [-SoftwareUpdateGroupId] <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>]

SearchByGroupNameMandatory

New-CMSoftwareUpdateAutoPhasedDeployment [-SoftwareUpdateGroupName] <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>]

SearchByIdMandatory

New-CMSoftwareUpdateAutoPhasedDeployment [-SoftwareUpdateIds] <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-CMSoftwareUpdateAutoPhasedDeployment [-SoftwareUpdateNames] <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>]

SearchByValueMandatory

New-CMSoftwareUpdateAutoPhasedDeployment [-SoftwareUpdates] <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>]

DESCRIPTION

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

Uwaga

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

EXAMPLES

Przykład 1: tworzenie wdrożenia według nazwy aktualizacji

Ten przykład tworzy nowe wdrożenie etapowe aktualizacji oprogramowania o nazwie myDPName dla aktualizacji oprogramowania myUpdateName.

New-CMSoftwareUpdateAutoPhasedDeployment -SoftwareUpdateName "myUpdateName" -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 aktualizacji

Ten przykład tworzy nowe wdrożenie etapowe aktualizacji oprogramowania o nazwie myPDName dla potokowego obiektu aktualizacji oprogramowania.

$myUpdate | New-CMSoftwareUpdateAutoPhasedDeployment -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-CMSoftwareUpdatePhase, 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 drugiego wdrożenia fazowego.

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 upływie okresu 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 aktualizacji oprogramowania.

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

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

-SoftwareUpdateGroup

Określ obiekt grupy aktualizacji oprogramowania.

Type: IResultObject
Parameter Sets: SearchByGroupMandatory
Aliases:

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

-SoftwareUpdateGroupId

Określ grupę aktualizacji oprogramowania według identyfikatora.

Type: String
Parameter Sets: SearchByGroupIdMandatory
Aliases:

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

-SoftwareUpdateGroupName

Określ grupę aktualizacji oprogramowania według nazwy.

Type: String
Parameter Sets: SearchByGroupNameMandatory
Aliases:

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

-SoftwareUpdateIds

Określ tablicę identyfikatorów aktualizacji oprogramowania.

Type: String[]
Parameter Sets: SearchByIdMandatory
Aliases:

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

-SoftwareUpdateNames

Określ tablicę nazw aktualizacji oprogramowania.

Type: String[]
Parameter Sets: SearchByNameMandatory
Aliases:

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

-SoftwareUpdates

Określ tablicę obiektów aktualizacji oprogramowania.

Type: IResultObject[]
Parameter Sets: SearchByValueMandatory
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
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.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

OUTPUTS

IResultObject#SMS_PhasedDeployment

UWAGI