Share via

New-CMSoftwareUpdateAutoPhasedDeployment

  • Cikk

SYNOPSIS

Ezzel a parancsmaggal többfázisú központi telepítést hozhat létre a szoftverfrissítések számára úgy, hogy két fázist hoz létre ugyanazokkal a beállításokkal.

SYNTAX

SearchByGroup kötelező

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

SearchByGroupId kötelező

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

SearchByGroupName kötelező

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

SearchById Kötelező

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

SearchByName Kötelező

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

A 2002-es verziótól kezdve ezzel a parancsmaggal hozhat létre szakaszos központi telepítést a szoftverfrissítések számára úgy, hogy két fázist hoz létre ugyanazokkal a beállításokkal. Ez a parancsmag ugyanúgy viselkedik, mint a szoftverfrissítések Fázisos központi telepítés létrehozása varázslója, ha kiválasztja az Alapértelmezett kétfázisú központi telepítés automatikus létrehozása beállítást.

Megjegyzés

Szakaszos központi telepítés létrehozása előtt győződjön meg arról, hogy a szoftverfrissítési tartalmat egy terjesztési pontra terjeszti.

EXAMPLES

1. példa: Üzemelő példány létrehozása a frissítés neve alapján

Ez a példa egy új, myDPName nevű szoftverfrissítési fázisú központi telepítést hoz létre a myUpdateName nevű szoftverfrissítéshez.

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"

2. példa: Üzembe helyezés létrehozása bemeneti frissítési objektum alapján

Ez a példa egy új, myPDName nevű szoftverfrissítési fázisú központi telepítést hoz létre egy áttért szoftverfrissítési objektumhoz.

$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 (Fázisok hozzáadása)

Ez a parancsmag automatikusan létrehoz két fázist a megadott két gyűjteményhez. Ezzel a paraméterrel további fázisokat is hozzáadhat. Adja meg a fázisok tömböt. A fázisok létrehozásához használja a New-CMSoftwareUpdatePhase parancsmagot.

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

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

-BeginCondition

Adjon meg egy beállítást az üzembe helyezés második fázisának első fázis sikeres megkezdése után:

  • AfterPeriod: Ez a paraméter megegyezik a következő beállítással a konzolOn Gépház létrehozási fázisú központi telepítés varázsló Gépház lapján: Ezt a fázist automatikusan kezdje el egy halasztási időszak után (napokban). Ha ezt az értéket adja meg, a DaysAfterPreviousPhaseSuccess értékkel konfigurálhatja az időszakot.

  • Manually: Ez a paraméter megegyezik a konzolOn Gépház Központi telepítés létrehozása varázsló Gépház beállításával: Manuálisan kezdje meg a második fázisú központi telepítést.

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

Jóváhagyást kér a parancsmag futtatása előtt.

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

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

-CriteriaOption

Adjon meg egy lehetőséget az első fázis sikerességére vonatkozó feltételek megadásához:

  • Compliance: Ez a paraméter megegyezik a konzolOn Gépház Központi telepítés létrehozása varázsló Gépház következő beállításával: Központi telepítés sikerességének százalékos aránya. Adja meg a százalékos értéket a CriteriaValue paraméterrel.

  • Number: Ez a paraméter megegyezik a konzolOn Gépház Központi telepítés létrehozása varázsló Gépház következő beállításával: A sikeresen telepített eszközök száma. Adja meg a CriteriaValue paraméterrel megadott eszközök számát.

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

Ez az egész szám a CriteriaOption beállításhoz megadott értéktől függ:

  • Compliance: Adja meg a százalékos arányt

  • Number: Adja meg az eszközök számát

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DaysAfterPreviousPhaseSuccess

A második fázis megkezdéséhez adjon meg egy egész számot az első fázis sikerességét követően ennyi nap után. Ez a paraméter megegyezik a következő beállítással a konzolOn Gépház központi telepítés létrehozása varázsló Gépház lapján: Halasztási időszak után (napokban) automatikusan megkezdi ezt a fázist.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DeadlineUnit

Adja meg a határidő időszakának típusát. Használja ezt a paramétert a DeadlineValue paraméterrel.

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 (Határidőérték)

Ez a paraméter csak akkor használatos, ha az AfterPeriod InstallationChoice paraméterrel van megadva.

Adjon meg egy egész számértéket a határidő időszakában. A DeadlineUnit paraméterrel adhatja meg a pont típusát: Hours , , , Days Weeks Months . Ez a paraméter megegyezik a konzolOn Gépház Központi telepítés létrehozása varázsló Gépház alábbi beállításával: A telepítésre ennyi idő után van szükség.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Description (Leírás)

Adja meg a szoftverfrissítés szakaszos központi telepítésének leírását.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

Ez a paraméter literál karakterértékekként kezeli a helyettesítő karaktereket. Nem kombinálhatja a ForceWildcardHandling használatával.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-FirstCollection

Adjon meg egy gyűjteményobjektumot az első fázishoz.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-FirstCollectionId

Adja meg az első fázis gyűjteményazonosítóját.

Type: String
Parameter Sets: (All)
Aliases:

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

-FirstCollectionName

Adja meg az első fázis gyűjteménynevét.

Type: String
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Ez a paraméter feldolgozza a helyettesítő karaktereket, és váratlan viselkedéshez vezethet. Ez nem ajánlott. Nem kombinálhatja a DisableWildcardHandling kártyával.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InsertAtOrder

Ha az AddPhases paramétert használja, ezzel a paraméterrel meghatározhatja, hogy a fázisok sorrendjében hová szúrja be a további fázisokat. Adjon meg egy egész számot a rendelési számmal.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-InstallationChoice

Adja meg a szoftver elérhetővé tevéséhez viszonyított viselkedési beállítást:

  • AsSoonAsPossible: Ez a paraméter megegyezik a konzolOn Gépház Központi telepítés létrehozása varázsló Gépház alábbi beállításával: A telepítésre a lehető leghamarabb szükség van.

  • AfterPeriod: Ez a paraméter megegyezik a konzolOn Gépház Központi telepítés létrehozása varázsló Gépház következő beállításával: A telepítésre ennyi idő után van szükség. Ha ezt az értéket adja meg, a DeadlineUnit és a DeadlineValue értékkel konfigurálhatja az időszakot.

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

Adja meg az alkalmazás szakaszos központi telepítésének nevét.

Type: String
Parameter Sets: (All)
Aliases:

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

-SecondCollection

Adjon meg egy gyűjteményobjektumot a második fázishoz.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-SecondCollectionId

Adja meg a második fázis gyűjteményazonosítóját.

Type: String
Parameter Sets: (All)
Aliases:

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

-SecondCollectionName

Adja meg a második fázis gyűjteménynevét.

Type: String
Parameter Sets: (All)
Aliases:

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

-SoftwareUpdateGroup

Adjon meg egy objektumot a szoftverfrissítési csoporthoz.

Type: IResultObject
Parameter Sets: SearchByGroupMandatory
Aliases:

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

-SoftwareUpdateGroupId

Adja meg a szoftverfrissítési csoportot azonosító alapján.

Type: String
Parameter Sets: SearchByGroupIdMandatory
Aliases:

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

-SoftwareUpdateGroupName

Adja meg a szoftverfrissítési csoportot név alapján.

Type: String
Parameter Sets: SearchByGroupNameMandatory
Aliases:

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

-SoftwareUpdateIds

Adja meg a szoftverfrissítési számok tömböt.

Type: String[]
Parameter Sets: SearchByIdMandatory
Aliases:

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

-SoftwareUpdateNames

Adja meg a szoftverfrissítések nevének tömböt.

Type: String[]
Parameter Sets: SearchByNameMandatory
Aliases:

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

-SoftwareUpdates

Adja meg a szoftverfrissítési objektumok tömböt.

Type: IResultObject[]
Parameter Sets: SearchByValueMandatory
Aliases:

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

-ThrottlingDays

Adjon meg egy egész számértéket a szoftver fokozatos elérhetővé tenni kívánt napok számára. Ez a paraméter megegyezik a konzolOn Gépház Központi telepítés létrehozása varázsló Gépház-oldalán található beállítással: Fokozatosan tegye elérhetővé ezt a szoftvert ebben az időszakban (napokban).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

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

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

CommonParameters

Ez a parancsmag a következő általános paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction és -WarningVariable. További információ: about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

OUTPUTS

IResultObject#SMS_PhasedDeployment

MEGJEGYZÉSEK