New-CMSoftwareUpdateAutoPhasedDeployment
Use este cmdlet para criar uma implantação em fases para atualizações de software gerando duas fases com as mesmas configurações.
Syntax
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
Use este cmdlet para criar uma implantação em fases para atualizações de software gerando duas fases com as mesmas configurações. O comportamento desse cmdlet é **** o mesmo do assistente Criar Implantação em Fases em uma atualização de software, quando você seleciona a opção para criar automaticamente uma implantação de duas fases padrão.
Observação
Antes de criar uma implantação em fases, certifique-se de distribuir o conteúdo de atualização de software para um ponto de distribuição.
Exemplos
Exemplo 1: Criar uma implantação pelo nome da atualização
Este exemplo cria uma nova implantação em fases de atualização de software chamada 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 implantação por objeto de atualização de entrada
Este exemplo cria uma nova implantação em fases de atualização de software chamada myPDName para um objeto de atualização de software canalizada.
$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
Esse cmdlet cria automaticamente duas fases para as duas coleções especificadas. Você também pode adicionar mais fases com esse parâmetro. 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 |
-BeginCondition
Especifique uma opção para iniciar a segunda fase de implantação após o sucesso da primeira fase:
AfterPeriod
: Este parâmetro é o mesmo que a configuração **** a seguir na página Configurações do assistente criar implantação em fases no console: inicie automaticamente essa fase após um período de adiamento (em dias). Se você especificar esse valor, use DaysAfterPreviousPhaseSuccess para configurar o período de tempo.Manually
: Este parâmetro é o mesmo que a configuração **** a seguir na página Configurações do assistente Criar Implantação em Fases no console: Iniciar manualmente a implantação da segunda fase.
Type: | BeginConditionType |
Accepted values: | AfterPeriod, Manually |
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 |
-CriteriaOption
Especifique uma opção para escolher os critérios de sucesso da primeira fase:
Compliance
: Este parâmetro é o mesmo que a configuração **** a seguir na página Configurações do assistente Criar Implantação em Fases no console: Porcentagem de sucesso de implantação. Especifique o valor percentual com o parâmetro CriteriaValue.Number
: Este parâmetro é o mesmo que a seguinte **** configuração na página Configurações do assistente Criar Implantação em Fases no console: Número de dispositivos implantados com êxito. Especifique o número de dispositivos com o parâmetro CriteriaValue.
Type: | CriteriaType |
Accepted values: | Compliance, Number |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CriteriaValue
Esse valor inteiro depende do valor especificado para CriteriaOption:
Compliance
: Especifique a porcentagemNumber
: Especifique o número de dispositivos
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DaysAfterPreviousPhaseSuccess
Especifique um valor inteiro para o número de dias após o sucesso da primeira fase para iniciar a segunda fase. Este parâmetro é o mesmo que a configuração a **** seguir na página Configurações do assistente Criar Implantação em Fases no console: Inicie automaticamente essa fase após um período de adiamento (em dias).
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineUnit
Especifique o tipo de período de prazo. Use este parâmetro com DeadlineValue.
Type: | TimeUnitType |
Accepted values: | Hours, Days, Weeks, Months |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineValue
Esse parâmetro só será usado se você especificar AfterPeriod
com o parâmetro InstallationChoice.
Especifique um valor inteiro para o período de tempo do prazo limite. Use o parâmetro DeadlineUnit para especificar o tipo de ponto: Hours
, , , Days
Weeks
Months
. Este parâmetro é o mesmo que a configuração **** a seguir na página Configurações do assistente criar implantação em fases no console: a instalação é necessária após esse período de tempo.
Type: | Int32 |
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 |
-FirstCollection
Especifique um objeto de coleção para a primeira fase.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FirstCollectionId
Especifique uma ID de coleção para a primeira fase.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FirstCollectionName
Especifique um nome de coleção para a primeira fase.
Type: | String |
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 é recomendável. Não é possível combiná-lo com DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InsertAtOrder
Se você usar o parâmetro AddPhases, use esse parâmetro para determinar onde, na ordem das fases, inserir as fases adicionais. Especifique um inteiro com o número do pedido.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstallationChoice
Especifique uma opção para o comportamento em relação ao momento em que o software é disponibilizado:
AsSoonAsPossible
: Este parâmetro é o mesmo que a configuração **** a seguir na página Configurações do assistente Criar Implantação em Fases no console: a instalação é necessária assim que possível.AfterPeriod
: Este parâmetro é o mesmo que a configuração **** a seguir na página Configurações do assistente Criar Implantação em Fases no console: a instalação é necessária após esse período de tempo. Se você especificar esse valor, use DeadlineUnit e DeadlineValue para configurar o período de tempo.
Type: | InstallationChoiceType |
Accepted values: | AsSoonAsPossible, AfterPeriod |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifique um nome para a implantação em fases do aplicativo.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecondCollection
Especifique um objeto de coleção para a segunda fase.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecondCollectionId
Especifique uma ID de coleção para a segunda fase.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SecondCollectionName
Especifique um nome de coleção para a segunda fase.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareUpdateGroup
Especifique um objeto para o grupo de atualização de software.
Type: | IResultObject |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SoftwareUpdateGroupId
Especifique o 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 o 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.
Type: | IResultObject[] |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ThrottlingDays
Especifique um valor inteiro para o número de dias para disponibilizar gradualmente esse software. Esse parâmetro é o mesmo que a configuração **** a seguir na página Configurações do assistente criar implantação em fases no console: disponibilizar gradualmente esse software durante esse período de tempo (em dias).
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
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