Configuration Manager библиотеки командлетов для версии 2002

Относится к Configuration Manager (Current Branch)

Примечание

Configuration Manager current branch version 1910 является базовым для этих изменений. Дополнительные сведения см. в Configuration Manager библиотеке командлетов для версии 1910.

Важные изменения

Новые командлеты

New-CMSoftwareUpdatePhase

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

New-CMSoftwareUpdatePhase `
 -CollectionName "MyCollection" `
 -PhaseName "MySUPhase"`
 -UserNotificationOption DisplaySoftwareCenterOnly

New-CMTaskSequencePhase

Используйте этот командлет, чтобы создать этап развертывания для последовательности задач.

New-CMTaskSequencePhase -CollectionName "MyCollection" -PhaseName "MyTSPhase" -UserNotification DisplayAll -AllowRemoteDP $true

Get-CMPhase

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

Get-CMPhase -Id "66DEDF86-D0CB-457D-88BE-47E3FAC92A47"
$myPhasedDeployment | Get-CMPhase

New-CMApplicationAutoPhasedDeployment

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

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"
 
$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"

New-CMSoftwareUpdateAutoPhasedDeployment

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

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"
$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"

New-CMSoftwareUpdateManualPhasedDeployment

Используйте этот командлет для создания поэтапного развертывания обновлений программного обеспечения. Сначала необходимо добавить новые настраиваемые этапы развертывания с помощью New-CMSoftwareUpdatePhase командлета.

$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)
 
$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)

New-CMTaskSequenceAutoPhasedDeployment

Используйте этот командлет, чтобы создать поэтапное развертывание для последовательности задач, создав два этапа с одинаковыми параметрами.

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"
 
$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"

New-CMTaskSequenceManualPhasedDeployment

Используйте этот командлет, чтобы создать поэтапное развертывание для последовательности задач. Сначала необходимо добавить новые настраиваемые этапы развертывания с помощью New-CMTaskSequencePhase командлета.

$phase1 = New-CMTaskSequencePhase -CollectionId "SMSDM001" -PhaseName "test01" -UserNotification DisplayAll
$phase2 = New-CMTaskSequencePhase -CollectionId "SMSDM003" -PhaseName "test02" -UserNotification HideAll
New-CMTaskSequenceManualPhasedDeployment -TaskSequenceName "myTaskSequence" -Name "phasedDeployment" -AddPhases ($phase1, $phase2)
 
$phase3 = New-CMTaskSequencePhase -CollectionId "SMSDM001" -PhaseName "test03" -UserNotification DisplayAll
$phase4 = New-CMTaskSequencePhase -CollectionId "SMSDM003" -PhaseName "test04" -UserNotification HideAll
$myTaskSequence | New-CMTaskSequenceManualPhasedDeployment -Name "phasedDeployment" -AddPhases ($phase3, $phase4)

Get-CMApplicationPhasedDeployment

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

Get-CMApplicationPhasedDeployment -Name "myPhasedDeploymentName"
 
Get-CMApplicationPhasedDeployment -ApplicationName "myApplicationName"

Get-CMSoftwareUpdatePhasedDeployment

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

Get-CMSoftwareUpdatePhasedDeployment -Name "myPhasedDeploymentName"
 
Get-CMSoftwareUpdatePhasedDeployment -SoftwareUpdateName "myUpdateName"

Get-CMTaskSequencePhasedDeployment

Используйте этот командлет, чтобы получить поэтапное развертывание последовательности задач.

Get-CMTaskSequencePhasedDeployment -Name "myPhasedDeploymentName"
 
Get-CMTaskSequencePhasedDeployment -TaskSequenceName "myTaskSequenceName"

Get-CMPhasedDeploymentStatus

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

Get-CMPhasedDeploymentStatus -Name "myPhasedDeploymentName"
 
$myPhasedDeployment | Get-CMPhasedDeploymentStatus -Catalog $catalog

Move-CMPhasedDeploymentToNext

Используйте этот командлет, чтобы переместить указанное поэтапное развертывание на следующий этап.

Move-CMPhasedDeploymentToNext -Name "myPhasedDeploymentName"  
 
$myPhasedDeployment | Move-CMPhasedDeploymentToNext -Force

Resume-CMPhasedDeployment

Используйте этот командлет, чтобы возобновить поэтапное развертывание из состояния приостановки.

Resume-CMPhasedDeployment -Name "myPhasedDeploymentName"  
 
$myPhasedDeployment | Resume-CMPhasedDeployment -Force

Suspend-CMPhasedDeployment

Используйте этот командлет, чтобы приостановить указанное поэтапное развертывание.

Suspend-CMPhasedDeployment -Name "myPhasedDeploymentName"
  
$myPhasedDeployment | Suspend-CMPhasedDeployment -Force

Remove-CMApplicationPhasedDeployment

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

Remove-CMApplicationPhasedDeployment -ApplicationName "myApplicationName"
 
Remove-CMApplicationPhasedDeployment -Name "myPhasedDeploymentName"
 
$myPhasedDeployment | Remove-CMApplicationPhasedDeployment -Force

Remove-CMSoftwareUpdatePhasedDeployment

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

Remove-CMSoftwareUpdatePhasedDeployment -SoftwareUpdateName "mySoftwareUpdateName"
 
Remove-CMSoftwareUpdatePhasedDeployment -SoftwareUpdateGroupName "mySoftwareUpdateGroupName"
 
Remove-CMSoftwareUpdatePhasedDeployment -Name "myPhasedDeploymentName"
 
$myPhasedDeployment | Remove-CMSoftwareUpdatePhasedDeployment -Force

Remove-CMTaskSequencePhasedDeployment

Используйте этот командлет, чтобы удалить поэтапное развертывание последовательности задач.

Remove-CMTaskSequencePhasedDeployment -TaskSequenceName "myTaskSequenceName"
 
Remove-CMTaskSequencePhasedDeployment -Name "myPhasedDeploymentName"
 
$myPhasedDeployment | Remove-CMTaskSequencePhasedDeployment -Force

Add-CMPassiveSite

Используйте этот командлет, чтобы добавить пассивный сайт.

Add-CMPassiveSite -InputObject $SiteSystem -InstallDirectory $InstallPath -SourceFilePathOption CopySourceFileFromActiveSite
Add-CMPassiveSite -SiteCode $SiteCode -SiteSystemServerName $SiteSystemServerName -InstallDirectory $InstallPath -SourceFilePathOption UseLocalSourceDirectory -LocalSourceDirectory $LocalSourcePath

Get-CMThirdPartyUpdateCategory

Используйте этот командлет, чтобы получить сторонние категории обновлений.

Get-CMThirdPartyUpdateCategory
Get-CMThirdPartyUpdateCategory -Catalog $catalog
Get-CMThirdPartyUpdateCategory -CatalogId $catalogId -Id $categoryId
Get-CMThirdPartyUpdateCategory -CatalogName $catalogName -Name $categoryName
$catalog | Get-CMThirdPartyUpdateCategory -ParentId $parentId -PublishOption $publishOption

Move-CMContentLibrary

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

Move-CMContentLibrary -InputObject $Site -NewLocation $NewLocationPath
Move-CMContentLibrary -SiteCode $SiteCode -NewLocation $NewLocationPath

Set-CMThirdPartyUpdateCategory

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

Set-CMThirdPartyUpdateCategory -Catalog $catalog -Id $categoryId -PublishOption $publishOption -EnableCategories $true
$catalog | Set-CMThirdPartyUpdateCategory -Name $categoryName -PublishOption $publishOption -EnableCategories $true
Set-CMThirdPartyUpdateCategory -CatalogId $catalogId -ParentId $parentId -PublishOption $publishOption -EnableCategories $true
Set-CMThirdPartyUpdateCategory -CatalogName $catalogName -Name $categoryName -ParentId $parentId -PublishOption $publishOption -EnableCategories $true
Set-CMThirdPartyUpdateCategory -Categories $categories -PublishOption $publishOption -EnableCategories $true

Нерекомендуемые командлеты

Нет

Известные проблемы

Нет

Изменения командлета

В существующие командлеты в этой версии были внесены следующие изменения. Изменения могут быть новыми функциями, исправлениями ошибок или устареванием. Некоторые изменения могут быть критическими. Если вы используете один из командлетов или функциональных областей, перечисленных в этом разделе, внимательно просмотрите изменения, чтобы понять, как они могут повлиять на использование.

Add-CMDeviceCollectionQueryMembershipRule

Некритные изменения

Добавлена дополнительная обработка ошибок для правила запроса.

Add-CMMsiDeploymentType

Некритные изменения

Добавлены следующие новые параметры, позволяющие настроить команду восстановления и параметры каталога при создании типа развертывания:

• RepairCommand
• RepairWorkingDirectory

Исправленные ошибки

Отсутствуют параметры для настройки команды восстановления и параметра каталога при создании типа развертывания.

Add-CMScriptDeploymentTypes

Критические изменения

Параметр -ContentLocation больше не будет принимать пустую папку.

Исправленные ошибки

Параметр -ContentLocation не должен разрешать пустую папку.

Add-CMUserCollectionQueryMembershipRule

Некритные изменения

Добавлена дополнительная обработка ошибок для правила запроса.

Import-CMSoftwareLicense

Некритные изменения

Исправлена проблема с ограничением параметров для параметра -Timeout.

New-CMApplicationDeployment

Некритные изменения

Добавлен следующий новый параметр, позволяющий настроить параметр восстановления приложения при создании развертывания для приложения:

• AllowRepairApp

Исправленные ошибки

Отсутствует параметр для настройки параметра восстановления приложения при создании развертывания приложения.

New-CMSiteSystem

Некритные изменения

Исправлена проверка для -SiteSystemServerName и -PublicFqdn.

Исправленные ошибки

Неправильное ограничение для указанных -SiteSystemServerName и -PublicFqdn.

New-CMTSRule

Некритные изменения

Имя переменной -ReferencedVariableName теперь принимает имя переменной, начинающееся с символа подчеркивания.

Исправленные ошибки

Параметр -ReferencedVariableName не позволяет пользователю указывать имя переменной, начинающееся с символа подчеркивания.

Set-CMApplicationDeployment

Некритные изменения

Добавлен следующий новый параметр, позволяющий настроить параметр восстановления приложения при настройке развертывания для приложения:

• AllowRepairApp

Исправленные ошибки

Отсутствует параметр для настройки параметра восстановления приложения при настройке развертывания приложения.

Set-CMMsiDeploymentType

Некритные изменения

Добавлены следующие новые параметры, позволяющие настраивать параметры команды восстановления и каталога при настройке типа развертывания:

• RepairCommand
• RepairWorkingDirectory

Исправленные ошибки

Отсутствуют параметры для настройки команды восстановления и параметра каталога при установке типа развертывания.

Set-CMSite

Некритные изменения

Добавлен следующий новый параметр, позволяющий повторить установку для неуданного пассивного сайта:

• RetryInstallPassiveSite

Добавлен следующий новый параметр, позволяющий повысить уровень пассивного сайта до активного:

• PromotePassiveSiteToActive

Set-CMScriptDeploymentType

Критические изменения

Параметр -ContentLocation больше не будет принимать пустую папку.

Исправленные ошибки

Параметр -ContentLocation не должен разрешать пустую папку.

Set-CMThirdPartyUpdateCatalog

Некритные изменения

• Теперь командлет поддерживает настройку "Расписание синхронизации" для каталога.
• Изменен вызов внутренней функции из-за изменения собственного метода.

Пример

Set-CMThirdPartyUpdateCatalog -Name $name –Schedule $schedule