New-CMSoftwareUpdateAutoPhasedDeployment

  • Artikel

SYNOPSIS

Gebruik deze cmdlet om een gefaseerd implementatie voor software-updates te maken door twee fasen met dezelfde instellingen te genereren.

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

Vanaf versie 2002 gebruikt u deze cmdlet om een gefaseerd implementatie voor software-updates te maken door twee fasen met dezelfde instellingen te genereren. Het gedrag van deze cmdlet is hetzelfde als de wizard Gefaseerd implementeren maken voor een software-update wanneer u de optie Selecteert om automatisch een standaardimplementatie in twee fasen te maken.

Notitie

Voordat u een gefaseerd implementatie maakt, moet u de inhoud van de software-update distribueren naar een distributiepunt.

EXAMPLES

Voorbeeld 1: Een implementatie maken op updatenaam

In dit voorbeeld wordt een nieuwe gefaseerd software-update-implementatie gemaakt met de naam myDPName voor de software-update 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"

Voorbeeld 2: Een implementatie maken op basis van het invoerupdateobject

In dit voorbeeld wordt een nieuwe gefaseerd software-update-implementatie met de naam myPDName gemaakt voor een software-updateobject met piped.

$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

Deze cmdlet maakt automatisch twee fasen voor de opgegeven twee verzamelingen. U kunt ook meer fasen toevoegen met deze parameter. Geef een matrix van fasen op. Gebruik New-CMSoftwareUpdatePhase om de fasen te maken.

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

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

-BeginCondition

Geef een optie op voor het begin van de tweede implementatiefase na het slagen van de eerste fase:

  • AfterPeriod: Deze parameter is dezelfde als de volgende instelling op de pagina Instellingen van de wizard Gefaseerd implementeren maken in de -console: deze fase automatisch starten na een uitstelperiode (in dagen). Als u deze waarde opgeeft, gebruikt u DaysAfterPreviousPhaseSuccess om de periode te configureren.

  • Manually: Deze parameter is hetzelfde als de volgende instelling op de pagina Instellingen van de wizard Gefaseerd implementeren maken in de -console: Handmatig beginnen met de implementatie van de tweede fase.

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

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

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

-CriteriaOption

Geef een optie op om de criteria voor het slagen van de eerste fase te kiezen:

  • Compliance: Deze parameter is dezelfde als de volgende instelling op de pagina Instellingen van de wizard Gefaseerd implementeren maken in de -console: Percentage implementatie geslaagd. Geef de percentagewaarde op met de parameter CriteriaValue.

  • Number: Deze parameter is hetzelfde als de volgende instelling op de pagina Instellingen van de wizard Gefaseerd implementeren maken in de -console: Aantal apparaten dat is geïmplementeerd. Geef het aantal apparaten op met de parameter 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

Deze gehele waarde is afhankelijk van de waarde die u opgeeft voor CriteriaOption:

  • Compliance: Geef het percentage op

  • Number: Geef het aantal apparaten op

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DaysAfterPreviousPhaseSuccess

Geef een geheel getal op voor het aantal dagen na het slagen van de eerste fase om de tweede fase te starten. Deze parameter is dezelfde als de volgende instelling op de pagina Instellingen van de wizard Gefaseerd implementeren maken in de -console: deze fase automatisch starten na een uitstelperiode (in dagen).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DeadlineUnit

Geef het type deadlineperiode op. Gebruik deze parameter met 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

Deze parameter wordt alleen gebruikt als u AfterPeriod opgeeft met de InstallationChoice parameter.

Geef een geheel getal op voor de periode voor de deadline. Gebruik de parameter DeadlineUnit om het type punt op te geven: Hours , , , Days Weeks Months . Deze parameter is dezelfde als de volgende instelling op de pagina Instellingen van de wizard Gefaseerd implementeren maken in de -console: Installatie is vereist na deze periode.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Beschrijving

Geef een beschrijving op voor de gefaseerd implementeren van software-updates.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-FirstCollection

Geef een verzamelingsobject op voor de eerste fase.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-FirstCollectionId

Geef een verzamelings-id op voor de eerste fase.

Type: String
Parameter Sets: (All)
Aliases:

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

-FirstCollectionName

Geef een verzamelingsnaam op voor de eerste fase.

Type: String
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag. Dit wordt niet aanbevolen. U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InsertAtOrder

Als u de parameter AddPhases gebruikt, gebruikt u deze parameter om te bepalen waar in de volgorde van de fasen de extra fasen moeten worden invoegen. Geef een geheel getal op met het ordernummer.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-InstallationChoice

Geef een optie op voor het gedrag ten opzichte van wanneer de software beschikbaar wordt gesteld:

  • AsSoonAsPossible: Deze parameter is hetzelfde als de volgende instelling op de pagina Instellingen van de wizard Gefaseerd implementeren maken in de -console: Installatie is zo snel mogelijk vereist.

  • AfterPeriod: Deze parameter is dezelfde als de volgende instelling op de pagina Instellingen van de wizard Gefaseerd implementeren maken in de -console: Installatie is vereist na deze periode. Als u deze waarde opgeeft, gebruikt u DeadlineUnit en DeadlineValue om de periode te configureren.

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

Geef een naam op voor de gefaseerd implementeren van de toepassing.

Type: String
Parameter Sets: (All)
Aliases:

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

-SecondCollection

Geef een verzamelingsobject op voor de tweede fase.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-SecondCollectionId

Geef een verzamelings-id op voor de tweede fase.

Type: String
Parameter Sets: (All)
Aliases:

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

-SecondCollectionName

Geef een verzamelingsnaam op voor de tweede fase.

Type: String
Parameter Sets: (All)
Aliases:

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

-SoftwareUpdateGroup

Geef een -object op voor de software-updategroep.

Type: IResultObject
Parameter Sets: SearchByGroupMandatory
Aliases:

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

-SoftwareUpdateGroupId

Geef de software-updategroep op id op.

Type: String
Parameter Sets: SearchByGroupIdMandatory
Aliases:

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

-SoftwareUpdateGroupName

Geef de software-updategroep op naam op.

Type: String
Parameter Sets: SearchByGroupNameMandatory
Aliases:

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

-SoftwareUpdateIds

Geef een matrix met software-update-ID's op.

Type: String[]
Parameter Sets: SearchByIdMandatory
Aliases:

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

-SoftwareUpdateNames

Geef een matrix met namen van software-updates op.

Type: String[]
Parameter Sets: SearchByNameMandatory
Aliases:

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

-SoftwareUpdates

Geef een matrix met software-updateobjecten op.

Type: IResultObject[]
Parameter Sets: SearchByValueMandatory
Aliases:

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

-ThrottlingDays

Geef een geheel getal op voor het aantal dagen dat deze software geleidelijk beschikbaar moet worden gemaakt. Deze parameter is dezelfde als de volgende instelling op de pagina Instellingen van de wizard Gefaseerd implementeren maken in de -console: Maak deze software geleidelijk beschikbaar gedurende deze periode (in dagen).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

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

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

OUTPUTS

IResultObject#SMS_PhasedDeployment

OPMERKINGEN