Configuration Manager modifications apportées à la bibliothèque d’applets de commande pour la version 2002

  • Article

S’applique à : Gestionnaire de Configuration (branche actuelle)

Notes

Configuration Manager current branch version 1910 est la base de référence de ces modifications. Pour plus d’informations, consultez Configuration Manager modifications apportées à la bibliothèque d’applets de commande pour la version 1910.

Modifications importantes

Nouvelles applets de commande

New-CMSoftwareUpdatePhase

Utilisez cette applet de commande pour créer une phase de déploiement pour la mise à jour logicielle.

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

New-CMTaskSequencePhase

Utilisez cette applet de commande pour créer une phase de déploiement pour une séquence de tâches.

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

Get-CMPhase

Utilisez cette applet de commande pour obtenir la phase de déploiement d’une instance spécifique ou d’un déploiement par phases.

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

New-CMApplicationAutoPhasedDeployment

Utilisez cette applet de commande pour créer un déploiement par phases pour une application en générant deux phases avec les mêmes paramètres.

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

Utilisez cette applet de commande pour créer un déploiement par phases pour les mises à jour logicielles en générant deux phases avec les mêmes paramètres.

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

Utilisez cette applet de commande pour créer un déploiement par phases pour les mises à jour logicielles. Vous devez d’abord ajouter de nouvelles phases de déploiement personnalisées avec l’applet de commande 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

Utilisez cette applet de commande pour créer un déploiement par phases pour une séquence de tâches en générant deux phases avec les mêmes paramètres.

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

Utilisez cette applet de commande pour créer un déploiement par phases pour une séquence de tâches. Vous devez d’abord ajouter de nouvelles phases de déploiement personnalisées avec l’applet de commande 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

Utilisez cette applet de commande pour obtenir le déploiement par phases pour une application.

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

Get-CMSoftwareUpdatePhasedDeployment

Utilisez cette applet de commande pour obtenir le déploiement par phases des mises à jour logicielles.

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

Get-CMTaskSequencePhasedDeployment

Utilisez cette applet de commande pour obtenir le déploiement par phases pour une séquence de tâches.

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

Get-CMPhasedDeploymentStatus

Utilisez cette applet de commande pour obtenir l’état d’un déploiement par phases spécifique.

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

Move-CMPhasedDeploymentToNext

Utilisez cette applet de commande pour déplacer le déploiement par phases spécifié vers la phase suivante.

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

Resume-CMPhasedDeployment

Utilisez cette applet de commande pour reprendre le déploiement par phases à partir de l’état de suspension.

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

Suspend-CMPhasedDeployment

Utilisez cette applet de commande pour interrompre le déploiement par phases spécifié.

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

Remove-CMApplicationPhasedDeployment

Utilisez cette applet de commande pour supprimer un déploiement par phases pour une application.

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

Remove-CMSoftwareUpdatePhasedDeployment

Utilisez cette applet de commande pour supprimer un déploiement par phases pour les mises à jour logicielles.

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

Remove-CMTaskSequencePhasedDeployment

Utilisez cette applet de commande pour supprimer un déploiement par phases pour une séquence de tâches.

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

Add-CMPassiveSite

Utilisez cette applet de commande pour ajouter un site passif.

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

Get-CMThirdPartyUpdateCategory

Utilisez cette applet de commande pour obtenir des catégories de mises à jour tierces.

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

Utilisez cette applet de commande pour déplacer la bibliothèque de contenu avant d’ajouter un site passif.

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

Set-CMThirdPartyUpdateCategory

Utilisez cette applet de commande pour modifier les catégories de mises à jour tierces.

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

Applets de commande déconseillées

Aucun

Problèmes connus

Aucun

Modifications apportées à l’applet de commande

Les modifications suivantes ont été apportées aux applets de commande existantes dans cette version. Les modifications peuvent être de nouvelles fonctionnalités, des correctifs de bogues ou une dépréciation. Certains changements peuvent être cassants. Si vous utilisez l’une des applets de commande ou des zones de fonctionnalité répertoriées dans cette section, examinez attentivement les modifications pour comprendre comment elles peuvent affecter votre utilisation.

Add-CMDeviceCollectionQueryMembershipRule

Changements non cassants

Ajout d’une gestion des erreurs supplémentaire pour la règle de requête.

Add-CMMsiDeploymentType

Changements non cassants

Ajout des nouveaux paramètres suivants pour vous permettre de configurer la commande de réparation et les options de répertoire lors de la création du type de déploiement :

  • RepairCommand
  • RepairWorkingDirectory

Bogues résolus

Paramètres manquants pour configurer la commande de réparation et l’option de répertoire lors de la création du type de déploiement.

Add-CMScriptDeploymentTypes

Changements cassants

-ContentLocation n’accepte plus de dossier vide.

Bogues résolus

-ContentLocation ne doit pas autoriser un dossier vide.

Add-CMUserCollectionQueryMembershipRule

Changements non cassants

Ajout d’une gestion des erreurs supplémentaire pour la règle de requête.

Import-CMSoftwareLicense

Changements non cassants

Correction d’un problème de délimitation de paramètre pour -Timeout.

New-CMApplicationDeployment

Changements non cassants

Ajout du nouveau paramètre suivant pour vous permettre de configurer l’option d’application de réparation lors de la création d’un déploiement pour une application :

  • AllowRepairApp

Bogues résolus

Paramètre manquant pour configurer l’option réparer l’application lors de la création du déploiement pour l’application.

New-CMSiteSystem

Changements non cassants

Correction de la validation pour -SiteSystemServerName et -PublicFqdn.

Bogues résolus

Limitation incorrecte pour les paramètres -SiteSystemServerName et -PublicFqdn spécifiés.

New-CMTSRule

Changements non cassants

Le -ReferencedVariableName accepte désormais le nom de la variable qui commence par le trait de soulignement.

Bogues résolus

-ReferencedVariableName n’autorise pas l’utilisateur à spécifier le nom de la variable commençant par le trait de soulignement.

Set-CMApplicationDeployment

Changements non cassants

Ajout du nouveau paramètre suivant pour vous permettre de configurer l’option d’application de réparation lorsque vous définissez le déploiement d’une application :

  • AllowRepairApp

Bogues résolus

Paramètre manquant pour configurer l’option réparer l’application lors du déploiement défini pour l’application.

Set-CMMsiDeploymentType

Changements non cassants

Ajout des nouveaux paramètres suivants pour vous permettre de configurer les options de commande et de répertoire de réparation lorsque vous définissez le type de déploiement :

  • RepairCommand
  • RepairWorkingDirectory

Bogues résolus

Paramètres manquants pour configurer la commande de réparation et l’option de répertoire lors de la définition du type de déploiement.

Set-CMSite

Changements non cassants

Ajout du nouveau paramètre suivant pour vous permettre de réessayer l’installation d’un site passif ayant échoué :

  • RetryInstallPassiveSite

Ajout du nouveau paramètre suivant pour vous permettre de promouvoir un site passif en site actif :

  • PromotePassiveSiteToActive

Set-CMScriptDeploymentType

Changements cassants

-ContentLocation n’accepte plus de dossier vide.

Bogues résolus

-ContentLocation ne doit pas autoriser un dossier vide.

Set-CMThirdPartyUpdateCatalog

Changements non cassants

  • L’applet de commande prend désormais en charge la définition de « Planification de synchronisation » pour un catalogue.
  • Modification d’un appel de fonction interne en raison d’une modification de méthode native.
Exemple
Set-CMThirdPartyUpdateCatalog -Name $name –Schedule $schedule