New-CMApplicationAutoPhasedDeployment

  • Artikel

SYNOPSIS

Använd den här cmdleten för att skapa en stegvis distribution för ett program genom att generera två faser med samma inställningar.

SYNTAX

SearchByValueMandatory

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

SearchByIdMandatory

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

SearchByNameMandatory

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

DESCRIPTION

Från och med version 2002 använder du denna cmdlet för att skapa en stegvis distribution för ett program genom att generera två faser med samma inställningar. Den här cmdletens beteende är detsamma som guiden Skapa fasindelade distribution i ett program, när du väljer alternativet för att automatiskt skapa en standarddistribution med två faser.

Anteckning

Innan du skapar en fasfasad distribution ska du distribuera programmets innehåll till en distributionsplats.

EXAMPLES

Exempel 1: Skapa en distribution efter appnamn

I det här exemplet skapas en ny programfasad distribution med namnet myDPName för programmet myApp.

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

Exempel 2: Skapa en distribution med indataappobjekt

I det här exemplet skapas en ny programfasad distribution med namnet myPDName för ett piped-programobjekt.

$myApp | New-CMApplicationAutoPhasedDeployment -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

-Program

Ange ett programobjekt för den fasfasade distributionen.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

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

-ApplicationId

Ange ett program-ID för den fasfasade distributionen.

Type: String
Parameter Sets: SearchByIdMandatory
Aliases: CIId, CI_ID

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

-ApplicationName

Ange ett programnamn för den fasfasade distributionen.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases: ApplicationLocalizedDisplayName

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

-BeginCondition

Ange ett alternativ för att börja den andra fasen av distributionen efter att den första fasen har lyckats:

  • AfterPeriod: Den här parametern är samma som följande inställning på sidan Inställningar i guiden Skapa fasindelade distribution i -konsolen: Starta automatiskt den här fasen efter en uppsenningsperiod (i dagar). Om du anger det här värdet använder du DaysAfterPreviousPhaseSuccess för att konfigurera tidsperioden.

  • Manually: Den här parametern är samma som följande inställning på sidan Inställningar i guiden Skapa fasindelade distribution i -konsolen: Starta distributionen av den andra fasen manuellt.

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

Uppmanar dig att bekräfta innan du kör cmdleten.

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

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

-CriteriaOption

Ange ett alternativ för att välja kriterier för att lyckas med den första fasen:

  • Compliance: Den här parametern är samma som följande inställning på sidan Inställningar i guiden Skapa fasindelade distribution i -konsolen: Distributionen lyckades i procent. Ange procentvärdet med parametern CriteriaValue.

  • Number: Den här parametern är samma som följande inställning Inställningar i guiden Skapa fasindelade distribution i -konsolen: Antal enheter som har distribuerats. Ange antalet enheter med parametern 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

Det här heltalsvärdet beror på det värde som du anger för CriteriaOption:

  • Compliance: Ange procentandelen

  • Number: Ange antalet enheter

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DaysAfterPreviousPhaseSuccess

Ange ett heltalsvärde för antalet dagar efter att den första fasen har lyckats för att påbörja den andra fasen. Den här parametern är samma som följande inställning på sidan Inställningar i guiden Skapa fasindelade distribution i -konsolen: Starta automatiskt den här fasen efter en uppsluppningsperiod (i dagar).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DeadlineUnit

Ange typ av tidsgränsperiod. Använd den här parametern med 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

Den här parametern används bara om du anger AfterPeriod med parametern InstallationChoice.

Ange ett heltalsvärde för tidsperioden för tidsgränsen. Använd parametern DeadlineUnit för att ange typen av period: Hours , , , Days Weeks Months . Den här parametern är samma som följande inställning på sidan Inställningar i guiden Skapa fasindelade distribution i -konsolen: Installation krävs efter den här tidsperioden.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Beskrivning

Ange en beskrivning för den programfasade distributionen.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-FirstCollection

Ange ett samlingsobjekt för den första fasen.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-FirstCollectionId

Ange ett samlings-ID för den första fasen.

Type: String
Parameter Sets: (All)
Aliases:

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

-FirstCollectionName

Ange ett samlingsnamn för den första fasen.

Type: String
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende. Det rekommenderas inte. Du kan inte kombinera den med DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InstallationChoice

Ange ett alternativ för beteendet i förhållande till när programvaran görs tillgänglig:

  • AsSoonAsPossible: Den här parametern är samma som följande inställning på sidan Inställningar i guiden Skapa fasindelade distribution i -konsolen: Installation krävs så snart som möjligt.

  • AfterPeriod: Den här parametern är samma som följande inställning på sidan Inställningar i guiden Skapa fasindelade distribution i -konsolen: Installation krävs efter den här tidsperioden. Om du anger det här värdet använder du DeadlineUnit och DeadlineValue för att konfigurera tidsperioden.

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

Ange ett namn för den programfasade distributionen.

Type: String
Parameter Sets: (All)
Aliases:

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

-SecondCollection

Ange ett samlingsobjekt för den andra fasen.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-SecondCollectionId

Ange ett samlings-ID för den andra fasen.

Type: String
Parameter Sets: (All)
Aliases:

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

-SecondCollectionName

Ange ett samlingsnamn för den andra fasen.

Type: String
Parameter Sets: (All)
Aliases:

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

-ThrottlingDays

Ange ett heltalsvärde för antalet dagar för att gradvis göra programvaran tillgänglig. Den här parametern är samma som följande inställning på sidan Inställningar i guiden Skapa stegvis distribution i -konsolen: Gör programvaran tillgänglig gradvis under den här tidsperioden (i dagar).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

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

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

CommonParameters

Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_PhasedDeployment

ANTECKNINGAR