Поделиться через


New-CMApplicationAutoPhasedDeployment

Используйте этот командлет для создания поэтапного развертывания приложения путем создания двух этапов с одинаковыми параметрами.

Синтаксис

New-CMApplicationAutoPhasedDeployment
   [-Application] <IResultObject>
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMApplicationAutoPhasedDeployment
   [-ApplicationId] <String>
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMApplicationAutoPhasedDeployment
   [-ApplicationName] <String>
   [-BeginCondition <BeginConditionType>]
   [-CriteriaOption <CriteriaType>]
   [-CriteriaValue <Int32>]
   [-DaysAfterPreviousPhaseSuccess <Int32>]
   [-DeadlineUnit <TimeUnitType>]
   [-DeadlineValue <Int32>]
   [-FirstCollection <IResultObject>]
   [-FirstCollectionId <String>]
   [-FirstCollectionName <String>]
   [-InstallationChoice <InstallationChoiceType>]
   [-SecondCollection <IResultObject>]
   [-SecondCollectionId <String>]
   [-SecondCollectionName <String>]
   [-ThrottlingDays <Int32>]
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Используйте этот командлет для создания поэтапного развертывания приложения путем создания двух этапов с одинаковыми параметрами. Поведение этого командлета совпадает с поведением мастера создания поэтапного развертывания в приложении при выборе параметра Автоматическое создание двухэтапного развертывания по умолчанию.

Примечание.

Перед созданием поэтапного развертывания обязательно распределите содержимое приложения в точку распространения.

Примеры

Пример 1. Создание развертывания по имени приложения

В этом примере создается новое поэтапное развертывание приложения с именем myDPName для приложения myApp.

New-CMApplicationAutoPhasedDeployment -ApplicationName "myApp" -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

Пример 2. Создание развертывания с помощью объекта входного приложения

В этом примере создается новое поэтапное развертывание приложения с именем myPDName для объекта приложения с каналом.

$myApp | New-CMApplicationAutoPhasedDeployment -Name "myPDName" -FirstCollectionID "SMSDM001" -SecondCollectionID "SMSDM003" -CriteriaOption Compliance -CriteriaValue 1 -BeginCondition AfterPeriod -DaysAfterPreviousPhaseSuccess 2 -ThrottlingDays 3 -InstallationChoice AfterPeriod -DeadlineUnit Hours -DeadlineValue 4 -Description "MyDescription"

Параметры

-Application

Укажите объект приложения для поэтапного развертывания.

Тип:IResultObject
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ApplicationId

Укажите идентификатор приложения для поэтапного развертывания.

Тип:String
Aliases:CIId, CI_ID
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ApplicationName

Укажите имя приложения для поэтапного развертывания.

Тип:String
Aliases:ApplicationLocalizedDisplayName
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-BeginCondition

Укажите параметр для начала второго этапа развертывания после успешного выполнения первого этапа:

  • AfterPeriod: этот параметр совпадает со следующим параметром на странице Параметры мастера создания поэтапного развертывания в консоли: автоматически начинается этот этап после периода отсрочки (в днях). Если указать это значение, используйте DaysAfterPreviousPhaseSuccess , чтобы настроить период времени.

  • Manually: этот параметр совпадает со следующим параметром на странице Параметры мастера создания поэтапного развертывания в консоли: начать второй этап развертывания вручную.

Тип:BeginConditionType
Допустимые значения:AfterPeriod, Manually
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

Перед запуском командлет запросит подтверждение.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CriteriaOption

Укажите параметр для выбора критериев успешного выполнения первого этапа:

  • Compliance: этот параметр совпадает со следующим параметром на странице Параметры мастера создания поэтапного развертывания в консоли: процент успешного развертывания. Укажите процентное значение с помощью параметра CriteriaValue .

  • Number: этот параметр совпадает со следующим параметром на странице Параметры мастера создания поэтапного развертывания в консоли: Количество устройств, успешно развернутых. Укажите количество устройств с помощью параметра CriteriaValue .

Тип:CriteriaType
Допустимые значения:Compliance, Number
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-CriteriaValue

Это целочисленное значение зависит от значения, указанного в параметре CriteriaOption:

  • Compliance: укажите процент.

  • Number: укажите количество устройств.

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DaysAfterPreviousPhaseSuccess

Укажите целочисленное значение для числа дней после успешного выполнения первого этапа, чтобы начать второй этап. Этот параметр совпадает со следующим параметром на странице Параметры мастера создания поэтапного развертывания в консоли: Автоматически начинать этот этап после периода отсрочки (в днях).

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DeadlineUnit

Укажите тип крайнего срока. Используйте этот параметр с DeadlineValue.

Тип:TimeUnitType
Допустимые значения:Hours, Days, Weeks, Months
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DeadlineValue

Этот параметр используется только при указании AfterPeriod с помощью параметра InstallationChoice .

Укажите целочисленное значение для периода времени для крайнего срока. Используйте параметр DeadlineUnit, чтобы указать тип точки: Hours, Days, Weeks, . Months Этот параметр совпадает со следующим параметром на странице Параметры мастера создания поэтапного развертывания в консоли: установка требуется по истечении этого периода времени.

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Description

Укажите описание поэтапного развертывания приложения.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-FirstCollection

Укажите объект коллекции для первого этапа.

Тип:IResultObject
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-FirstCollectionId

Укажите идентификатор коллекции для первого этапа.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-FirstCollectionName

Укажите имя коллекции для первого этапа.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению. Это не рекомендуется. Его нельзя объединить с DisableWildcardHandling.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InstallationChoice

Укажите параметр для поведения относительно того, когда программное обеспечение становится доступным:

  • AsSoonAsPossible: этот параметр совпадает со следующим параметром на странице Параметры мастера создания поэтапного развертывания в консоли: установка требуется как можно скорее.

  • AfterPeriod: этот параметр совпадает со следующим параметром на странице Параметры мастера создания поэтапного развертывания в консоли: установка требуется по истечении этого периода времени. Если указать это значение, используйте DeadlineUnit и DeadlineValue , чтобы настроить период времени.

Тип:InstallationChoiceType
Допустимые значения:AsSoonAsPossible, AfterPeriod
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

Укажите имя поэтапного развертывания приложения.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SecondCollection

Укажите объект коллекции для второго этапа.

Тип:IResultObject
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SecondCollectionId

Укажите идентификатор коллекции для второго этапа.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SecondCollectionName

Укажите имя коллекции для второго этапа.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ThrottlingDays

Укажите целочисленное значение для количества дней, чтобы постепенно сделать это программное обеспечение доступным. Этот параметр совпадает со следующим параметром на странице Параметры мастера создания поэтапного развертывания в консоли: постепенно делайте это программное обеспечение доступным в течение этого периода времени (в днях).

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Выходные данные

IResultObject