Share via

New-CMSoftwareUpdateManualPhasedDeployment

  • Referência
Módulo:
ConfigurationManager

Crie uma implantação em fases para atualizações de software.

Syntax

New-CMSoftwareUpdateManualPhasedDeployment
   [-SoftwareUpdateGroup] <IResultObject>
   -AddPhases <Phase[]>
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateManualPhasedDeployment
   [-SoftwareUpdateGroupId] <String>
   -AddPhases <Phase[]>
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateManualPhasedDeployment
   [-SoftwareUpdateGroupName] <String>
   -AddPhases <Phase[]>
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateManualPhasedDeployment
   [-SoftwareUpdateIds] <String[]>
   -AddPhases <Phase[]>
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateManualPhasedDeployment
   [-SoftwareUpdateNames] <String[]>
   -AddPhases <Phase[]>
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMSoftwareUpdateManualPhasedDeployment
   [-SoftwareUpdates] <IResultObject[]>
   -AddPhases <Phase[]>
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para criar uma implantação em fases para atualizações de software. Antes de usar esse cmdlet, adicione novas fases de implantação personalizadas com o cmdlet New-CMSoftwareUpdatePhase.

Para obter mais informações, consulte Create phased deployments with Configuration Manager.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Criar uma implantação para atualizações de software pelo nome

Este exemplo cria uma implantação em duas fases chamada myPhaseDeployment para duas atualizações de software.

$phase1 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM001" -PhaseName "test01" -UserNotificationOption DisplaySoftwareCenterOnly
$phase2 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM003" -PhaseName "test02" -UserNotificationOption DisplaySoftwareCenterOnly
New-CMSoftwareUpdateManualPhasedDeployment -SoftwareUpdateNames ("myUpdateA", "myUpdateB") -Name "myPhaseDeployment" -AddPhases ($phase1, $phase2)

Exemplo 2: Criar uma implantação para um grupo de atualização de software pelo nome

Este exemplo cria uma implantação em duas fases chamada myPhaseDeploymentForGroup para o grupo de atualização de software myGroup.

$phase3 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM001" -PhaseName "test03" -UserNotificationOption DisplaySoftwareCenterOnly
$phase4 = New-CMSoftwareUpdatePhase -CollectionId "SMSDM003" -PhaseName "test04" -UserNotificationOption DisplaySoftwareCenterOnly
New-CMSoftwareUpdateManualPhasedDeployment -SoftwareUpdateGroupName "myGroup" -Name "myPhaseDeploymentForGroup" -AddPhases ($phase3, $phase4)

Parâmetros

-AddPhases

Especifique uma matriz de fases. Use New-CMSoftwareUpdatePhase para criar as fases.

Type:Phase[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Description

Especifique uma descrição para a implantação em fases de atualização de software.

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

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

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

-Name

Especifique um nome para a implantação em fases de atualização de software.

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

-SoftwareUpdateGroup

Especifique um objeto para um grupo de atualização de software. Para obter esse objeto, use o cmdlet Get-CMSoftwareUpdateGroup.

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

-SoftwareUpdateGroupId

Especifique um grupo de atualização de software por ID.

Type:String
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SoftwareUpdateGroupName

Especifique um grupo de atualização de software pelo nome.

Type:String
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SoftwareUpdateIds

Especifique uma matriz de IDs de atualização de software.

Type:String[]
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SoftwareUpdateNames

Especifique uma matriz de nomes de atualização de software.

Type:String[]
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SoftwareUpdates

Especifique uma matriz de objetos de atualização de software. Para obter esse objeto, use o cmdlet Get-CMSoftwareUpdate.

Type:IResultObject[]
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Saídas

IResultObject

Observações

O objeto return é a classe WMI do SMS_PhasedDeployment server.