Compartilhar via


New-CMSoftwareUpdateAutoPhasedDeployment

Utilize este cmdlet para criar uma implementação faseada para atualizações de software ao gerar duas fases com as mesmas definições.

Sintaxe

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

Utilize este cmdlet para criar uma implementação faseada para atualizações de software ao gerar duas fases com as mesmas definições. O comportamento deste cmdlet é o mesmo que o assistente Criar Implementação Faseada numa atualização de software, quando seleciona a opção para Criar automaticamente uma implementação de duas fases predefinida.

Observação

Antes de criar uma implementação faseada, certifique-se de que distribui o conteúdo da atualização de software para um ponto de distribuição.

Exemplos

Exemplo 1: Criar uma implementação por nome de atualização

Este exemplo cria uma nova implementação faseada de atualização de software com o nome myDPName para a atualização de software 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"

Exemplo 2: Criar uma implementação por objeto de atualização de entrada

Este exemplo cria uma nova implementação faseada de atualização de software com o nome myPDName para um objeto de atualização de software 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"

Parâmetros

-AddPhases

Este cmdlet cria automaticamente duas fases para as duas coleções especificadas. Também pode adicionar mais fases com este parâmetro. Especifique uma matriz de fases. Utilize New-CMSoftwareUpdatePhase para criar as fases.

Tipo:Phase[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-BeginCondition

Especifique uma opção para iniciar a segunda fase de implementação após o êxito da primeira fase:

  • AfterPeriod: este parâmetro é o mesmo que a seguinte definição na página Definições do assistente Criar Implementação Faseada na consola do : Iniciar automaticamente esta fase após um período de diferimento (em dias). Se especificar este valor, utilize DaysAfterPreviousPhaseSuccess para configurar o período de tempo.

  • Manually: este parâmetro é o mesmo que a seguinte definição na página Definições do assistente Criar Implementação Faseada na consola do : Iniciar manualmente a implementação da segunda fase.

Tipo:BeginConditionType
Valores aceitos:AfterPeriod, Manually
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CriteriaOption

Especifique uma opção para escolher os critérios de êxito da primeira fase:

  • Compliance: este parâmetro é o mesmo que a seguinte definição na página Definições do assistente Criar Implementação Faseada na consola: Percentagem de êxito da implementação. Especifique o valor de percentagem com o parâmetro CriteriaValue .

  • Number: este parâmetro é o mesmo que a seguinte definição na página Definições do assistente Criar Implementação Faseada na consola do : Número de dispositivos implementados com êxito. Especifique o número de dispositivos com o parâmetro CriteriaValue .

Tipo:CriteriaType
Valores aceitos:Compliance, Number
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CriteriaValue

Este valor inteiro depende do valor que especificar para CriteriaOption:

  • Compliance: especifique a percentagem

  • Number: especifique o número de dispositivos

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DaysAfterPreviousPhaseSuccess

Especifique um valor inteiro para o número de dias após o êxito da primeira fase para iniciar a segunda fase. Este parâmetro é o mesmo que a seguinte definição na página Definições do assistente Criar Implementação Faseada na consola do : Iniciar automaticamente esta fase após um período de diferimento (em dias).

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeadlineUnit

Especifique o tipo de período de prazo. Utilize este parâmetro com DeadlineValue.

Tipo:TimeUnitType
Valores aceitos:Hours, Days, Weeks, Months
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeadlineValue

Este parâmetro só é utilizado se especificar AfterPeriod com o parâmetro InstallationChoice .

Especifique um valor inteiro para o período de tempo do prazo. Utilize o parâmetro DeadlineUnit para especificar o tipo de período: Hours, Days, , Weeks. Months Este parâmetro é o mesmo que a seguinte definição na página Definições do assistente Criar Implementação Faseada na consola do : a instalação é necessária após este período de tempo.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Description

Especifique uma descrição para a implementação faseada da atualização de software.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FirstCollection

Especifique um objeto de coleção para a primeira fase.

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FirstCollectionId

Especifique um ID de coleção para a primeira fase.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FirstCollectionName

Especifique um nome de coleção para a primeira fase.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado. Não é recomendado. Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InsertAtOrder

Se utilizar o parâmetro AddPhases , utilize este parâmetro para determinar onde na ordem das fases para inserir as fases adicionais. Especifique um número inteiro com o número da encomenda.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InstallationChoice

Especifique uma opção para o comportamento relativo ao momento em que o software é disponibilizado:

  • AsSoonAsPossible: este parâmetro é o mesmo que a seguinte definição na página Definições do assistente Criar Implementação Faseada na consola do : a instalação é necessária o mais rapidamente possível.

  • AfterPeriod: este parâmetro é o mesmo que a seguinte definição na página Definições do assistente Criar Implementação Faseada na consola do : a instalação é necessária após este período de tempo. Se especificar este valor, utilize DeadlineUnit e DeadlineValue para configurar o período de tempo.

Tipo:InstallationChoiceType
Valores aceitos:AsSoonAsPossible, AfterPeriod
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifique um nome para a implementação faseada da aplicação.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SecondCollection

Especifique um objeto de coleção para a segunda fase.

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SecondCollectionId

Especifique um ID de coleção para a segunda fase.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SecondCollectionName

Especifique um nome de coleção para a segunda fase.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SoftwareUpdateGroup

Especifique um objeto para o grupo de atualização de software.

Tipo:IResultObject
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-SoftwareUpdateGroupId

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

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SoftwareUpdateGroupName

Especifique o grupo de atualizações de software por nome.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SoftwareUpdateIds

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

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SoftwareUpdateNames

Especifique uma matriz de nomes de atualizações de software.

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SoftwareUpdates

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

Tipo:IResultObject[]
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ThrottlingDays

Especifique um valor inteiro para o número de dias para disponibilizar gradualmente este software. Este parâmetro é o mesmo que a seguinte definição na página Definições do assistente Criar Implementação Faseada na consola do : disponibilizar gradualmente este software ao longo deste período de tempo (em dias).

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Saídas

IResultObject