Dela via


Set-CMSoftwareUpdatePhasedDeployment

SYNOPSIS

Konfigurera en fasfasad distribution för en programuppdatering.

SYNTAX

SearchByValue

Set-CMSoftwareUpdatePhasedDeployment [-AddPhases <Phase[]>] [-Description <String>]
 -InputObject <IResultObject> [-NewName <String>] [-PassThru] [-RemovePhaseIds <String[]>]
 [-RemovePhaseOrders <Int32[]>] [-RemovePhases <Phase[]>] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

SearchById

Set-CMSoftwareUpdatePhasedDeployment [-AddPhases <Phase[]>] [-Description <String>] [-NewName <String>]
 [-PassThru] [-RemovePhaseIds <String[]>] [-RemovePhaseOrders <Int32[]>] [-RemovePhases <Phase[]>] -Id <String>
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SearchByName

Set-CMSoftwareUpdatePhasedDeployment [-AddPhases <Phase[]>] [-Description <String>] [-NewName <String>]
 [-PassThru] [-RemovePhaseIds <String[]>] [-RemovePhaseOrders <Int32[]>] [-RemovePhases <Phase[]>]
 -Name <String> [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Gäller för version 2006 och senare. Konfigurera en fasfasad distribution för en programuppdatering. Mer information finns i Skapa fasdistributioner.

EXAMPLES

Exempel 1: Byt namn på en fasdistribution

Det här exemplet byter namn på en programuppdateringsfasad distribution som skickas via kommandoraden.

$suPhasedDeployment = Get-CMSoftwareUpdatePhasedDeployment -Name "myPhasedDeployment"

$suPhasedDeployment | Set-CMSoftwareUpdatePhasedDeployment -NewName "New SU phased deployment" -Description "New description" -PassThru

Exempel 2: Lägg till en fas

I det här exemplet läggs en fas till i en programuppdateringsfasdistribution som är mål för dess ID.

$newPhase = New-CMSoftwareUpdatePhase -CollectionName "MyCollection" -PhaseName "MySUPhase" -UserNotificationOption DisplaySoftwareCenterOnly

Set-CMSoftwareUpdatePhasedDeployment -Id "da0a01a3-b7ea-4d4b-8392-94b39ecabf8b" -AddPhases ($newPhase)

PARAMETERS

-AddPhases

Använd den här parametern för att lägga till en eller flera faser i en distribution i programuppdateringsfasen. Använd cmdleten New-CMSoftwareUpdatePhase för att skapa ett nytt fasobjekt.

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

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

-Beskrivning

Ange en valfri beskrivning för att bättre identifiera distributionen av programuppdateringsfasen.

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

-ForceWildcardHandling

Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (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

-Id

Ange ID:t för den fasdelade programuppdateringsdistributionen som ska konfigureras. Formatet för det här värdet är ett GUID.

Type: String
Parameter Sets: SearchById
Aliases: PhasedDeploymentId

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

-InputObject

Ange ett objekt för en programuppdateringsfasad distribution som ska konfigureras. Använd till exempel cmdleten Get-CMSoftwareUpdatePhasedDeployment för att hämta det här objektet.

Type: IResultObject
Parameter Sets: SearchByValue
Aliases: PhasedDeployment

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

-Name

Ange namnet på den programuppdateringsfasad distribution som ska konfigureras.

Type: String
Parameter Sets: SearchByName
Aliases:

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

-NewName

Använd den här parametern för att byta namn på programuppdateringsfasens distribution.

Type: String
Parameter Sets: (All)
Aliases:

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

-PassThru

Returnerar ett objekt som representerar det objekt som du arbetar med. Som standard genererar denna cmdlet kanske inte några utdata.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-RemovePhaseIds

Ta bort en eller flera faser som anges av deras ID.

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

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

-RemovePhaseOrders

Ta bort en eller flera faser som anges i deras ordning i den stegvisa distributionen.

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

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

-RemovePhases

Ta bort en eller flera faser från en stegvis programuppdateringsdistribution. Använd cmdleten Get-CMPhase för att identifiera fasen som ska tas bort.

Type: Phase[]
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

Get-CMSoftwareUpdatePhasedDeployment

New-CMSoftwareUpdateAutoPhasedDeployment

New-CMSoftwareUpdateManualPhasedDeployment

Remove-CMSoftwareUpdatePhasedDeployment

Get-CMPhase

New-CMSoftwareUpdatePhase

Set-CMSoftwareUpdatePhase

Get-CMPhasedDeploymentStatus

Move-CMPhasedDeploymentToNext

Resume-CMPhasedDeployment

Suspend-CMPhasedDeployment

Skapa fasdistributioner