New-CMTaskSequenceAutoPhasedDeployment

  • Artigo

SYNOPSIS

Utilize este cmdlet para criar uma implementação faseada para uma sequência de tarefas gerando duas fases com as mesmas definições.

SYNTAX

SearchByValueMandatory

New-CMTaskSequenceAutoPhasedDeployment [-TaskSequence] <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>]

SearchByIdMandatory

New-CMTaskSequenceAutoPhasedDeployment [-TaskSequenceId] <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>]

PesquisaByNameMandatory

New-CMTaskSequenceAutoPhasedDeployment [-TaskSequenceName] <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>]

DESCRIPTION

A partir da versão 2002, utilize este cmdlet para criar uma implementação faseada para uma sequência de tarefas gerando duas fases com as mesmas definições. O comportamento deste cmdlet é o mesmo que o assistente de implementação faseada de criar numa sequência de tarefas, quando seleciona a opção para criar automaticamente uma implementação de duas fases predefinido.

Nota

Antes de criar uma implementação faseada, certifique-se de distribuir o conteúdo da sequência de tarefas num ponto de distribuição.

EXAMPLES

Exemplo 1: Criar uma implementação por nome de sequência de tarefa

Este exemplo cria uma nova função de implementação faseada chamada myDPName para a sequência de tarefas myTaskSequenceName.

New-CMTaskSequenceAutoPhasedDeployment -TaskSequenceName "myTaskSequenceName" -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 sequência de tarefa de entrada

Este exemplo cria uma nova sequência de tarefas de implementação faseada chamada myPDName para um objeto de sequência de tarefa canalizado.

$myTS | New-CMTaskSequenceAutoPhasedDeployment -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

-AddFaseses

Este cmdlet cria automaticamente duas fases para as duas coleções especificadas. Também pode adicionar mais fases com este parâmetro. Especifique um conjunto de fases. Utilize A Nova CMTaskSequencePhase para criar as fases.

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

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

-Iniciar a Condição

Especificar 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 seguinte definição na página Definições do assistente de implantação faseada da consola: Inicie 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 de implantação faseada da consola: Iniciar manualmente a segunda fase.

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

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

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

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

-CritériosOpção

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

  • Compliance: Este parâmetro é o mesmo que a seguinte definição na página Definições do assistente de implantação faseada da consola: Percentagem de sucesso da implementação. Especifique o valor percentual com o parâmetro CriteriaValue.

  • Number: Este parâmetro é o mesmo que a seguinte definição na página Definições do assistente de implantação faseada da consola: Número de dispositivos implantados com sucesso. Especificar o número de dispositivos com o parâmetro 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

-CritériosValue

Este valor inteiro depende do valor que especifica para critérioOpoption:

  • Compliance: Especificar a percentagem

  • Number: Especificar o número de dispositivos

Type: Int32
Parameter Sets: (All)
Aliases:

Required: False
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 seguinte definição na página Definições do assistente de implementação faseada da consola: Inicie automaticamente esta fase após um período de diferimento (em dias).

Type: Int32
Parameter Sets: (All)
Aliases:

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

-DeadlineUnit

Especifique o tipo de prazo. Utilize este parâmetro com o 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

-PrazoSValue

Este parâmetro só é utilizado se especificar AfterPeriod com o parâmetro InstalaçãoChoice.

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 de implantação faseada da consola: A instalação é necessária após este período de tempo.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Descrição

Especifique uma descrição para a implantação faseada da sequência de tarefas.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-PrimeiraCollecta

Especifique um objeto de recolha para a primeira fase.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-FirstCollectionId

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

Type: String
Parameter Sets: (All)
Aliases:

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

-Primeiro Nome deCollection

Especifique um nome de recolha para a primeira fase.

Type: String
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado. Não é recomendado. Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: 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.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-InstalaçãoChoice

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 seguinte definição na página Definições do assistente de implantação faseada da consola: 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 de implantação faseada da consola: A instalação é necessária após este período de tempo. Se especificar este valor, use a DeadlineUnit e a DeadlineValue para configurar o período de tempo.

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

Especifique um nome para a implantação faseada da sequência de tarefas.

Type: String
Parameter Sets: (All)
Aliases:

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

-SegundaCollectcão

Especifique um objeto de recolha para a segunda fase.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-SecondCollectionId

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

Type: String
Parameter Sets: (All)
Aliases:

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

-Segundo Nome deCollection

Especifique um nome de recolha para a segunda fase.

Type: String
Parameter Sets: (All)
Aliases:

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

-TaskSequence

Especifique um objeto de sequência de tarefa.

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

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

-TaskSequenceId

Especifique uma sequência de tarefa por ID.

Type: String
Parameter Sets: SearchByIdMandatory
Aliases: TaskSequencePackageId

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

- Nome de Tarefasequence

Especifique uma sequência de tarefa pelo nome.

Type: String
Parameter Sets: SearchByNameMandatory
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: 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 de implementação faseada da consola: Gradualmente disponibilizar este software ao longo deste período de tempo (em dias).

Type: Int32
Parameter Sets: (All)
Aliases:

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

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

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

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

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

IResultObject#SMS_PhasedDeployment

NOTAS