Configuration Manager modifications apportées à la bibliothèque d’applets de commande pour la version 2002
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