Configuration Manager les modifications de la bibliothèque d’applets de commande pour la version 2107

S’applique à : Configuration Manager (Current Branch)

Ces notes de publication résument les modifications apportées à la bibliothèque d’applets de commande Configuration Manager dans la version 2107.

Nouvelles applets de commande pour les types de déploiement d’applications

Gérer les comportements d’installation pour les types de déploiement d’application

Cet ensemble de nouvelles applets de commande concerne le comportement de l’installation du type de déploiement d’application. Pour plus d’informations générales sur la fonctionnalité de comportement à l’installation, consultez Vérifier les fichiers exécutables en cours d’exécution.

Add-CMDeploymentTypeInstallBehavior

Utilisez cette cmdlet pour ajouter au type de déploiement spécifié les fichiers exécutables qui doivent être fermés pour que l’installation de l’application aboutisse.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe" -DisplayName "Notepad"

Pour plus d’informations, consultez Add-CMDeploymentTypeInstallBehavior.

Get-CMDeploymentTypeInstallBehavior

Utilisez cette cmdlet pour obtenir à partir du type de déploiement spécifié la liste des fichiers exécutables qui doivent être fermés pour que l’installation de l’application aboutisse.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Get-CMDeploymentTypeInstallBehavior -InputObject $msi_dt

Pour plus d’informations, consultez la page obtenir-CMDeploymentTypeInstallBehavior.

Remove-CMDeploymentTypeInstallBehavior

Utilisez cette cmdlet pour supprimer du type de déploiement spécifié les fichiers exécutables qui doivent être fermés pour que l’installation de l’application aboutisse.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Remove-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe"

Pour plus d’informations, consultez Remove-CMDeploymentTypeInstallBehavior.

Set-CMDeploymentTypeInstallBehavior

Utilisez cette cmdlet pour modifier les fichiers exécutables qui doivent être fermés pour que l’installation de l’application aboutisse.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Set-CMDeploymentTypeInstallBehavior -InputObject $msi_dt -ExeFileName "notepad.exe" -NewExeFileName "calc.exe" -DisplayName "Calculator"

Pour plus d’informations, consultez Set-CMDeploymentTypeInstallBehavior.

Gérer les codes de retour pour les types de déploiement d’application

Cet ensemble de nouvelles applets de commande est destiné aux codes de retour du type de déploiement d’application. Pour plus d’informations générales, consultez Codes de retour du type de déploiement.

Add-CMDeploymentTypeReturnCode

Utilisez cette cmdlet pour ajouter des codes de retour à un type de déploiement pris en charge.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 1602 -Name "User cancel" -CodeType Failure -Description "The user cancelled the installation"

Pour plus d’informations, consultez Add-CMDeploymentTypeReturnCode.

Get-CMDeploymentTypeReturnCode

Utilisez cette cmdlet pour obtenir la liste des codes de retour du type de déploiement spécifié.

Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)" | Get-CMDeploymentTypeReturnCode

Pour plus d’informations, consultez la page obtenir-CMDeploymentTypeReturnCode.

Remove-CMDeploymentTypeReturnCode

Utilisez cette cmdlet pour supprimer les codes de retour du type de déploiement spécifié.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Remove-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 1602

Pour plus d’informations, consultez Remove-CMDeploymentTypeReturnCode.

Set-CMDeploymentTypeReturnCode

Utilisez cette cmdlet pour modifier les codes de retour pour le type de déploiement spécifié.

$msi_dt = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"
Add-CMDeploymentTypeReturnCode -InputObject $msi_dt -ReturnCode 3010 -Name "Always reboot" -CodeType HardReboot -Description "Change soft reboot to hard reboot"

Pour plus d’informations, consultez Set-CMDeploymentTypeReturnCode.

Autres nouvelles cmdlets

Get-CMClientSettingDeployment

Utilisez cette cmdlet pour obtenir le déploiement d’un objet de paramètres client personnalisé. Vous pouvez utiliser cet objet avec Remove-CMClientSettingDeployment.

Pour plus d’informations sur les paramètres client, consultez Guide pratique pour configurer des paramètres client.

$clientSetting =  Get-CMClientSetting -Name "Software Center customizations"
$clientSetting | Get-CMClientSettingDeployment

Pour plus d’informations, consultez la page obtenir-CMClientSettingDeployment.

Get-CMDeploymentTypeDetectionClause

Utilisez cette applet de commande pour récupérer les clauses de détection à partir du type de déploiement spécifié.

Vous pouvez utiliser cette cmdlet pour obtenir une clause de détection d’une application et l’appliquer à une autre, par exemple :

$appMsi = Get-CMDeploymentType -ApplicationName "CenterApp" -DeploymentTypeName "InterDept - Windows Installer (.msi file)"

$clause1 = Get-CMDeploymentTypeDetectionClause -InputObject $appMsi

Set-CMScriptDeploymentType -ApplicationName "Configuration Manager console" -DeploymentTypeName "Install" -AddDetectionClause $clause1

Pour plus d’informations, consultez la page obtenir-CMDeploymentTypeDetectionClause.

Get-CMPersistentUserSettingsGroup

Utilisez cette cmdlet pour récupérer la liste des paramètres de l’ensemble du site que vous avez stockés. Ces paramètres vous suivent sur différents appareils.

Par exemple, les notifications de la console Configuration Manager qui sont actives ou que vous avez ignorées.

Pour plus d’informations, consultez la page obtenir-CMPersistentUserSettingsGroup.

Get-CMSoftwareUpdateContentInfo

Utilisez cette applet de commande pour récupérer les informations de contenu des mises à jour logicielles.

$update = Get-CMSoftwareUpdate -ArticleId "5004237" -Fast
Get-CMSoftwareUpdateContentInfo -InputObject $update[1]

Pour plus d’informations, consultez la page obtenir-CMSoftwareUpdateContentInfo.

Remove-CMPersistentUserSettingsGroup

Utilisez cette cmdlet pour réinitialiser les paramètres de l’ensemble du site.

Par exemple, vous pouvez restaurer les notifications de la console Configuration Manager que vous avez ignorées. Après l’exécution de cette cmdlet, quand vous redémarrez la console Configuration Manager, vous voyez à nouveau toutes les notifications disponibles.

Pour plus d’informations, consultez Remove-CMPersistentUserSettingsGroup.

Applets de commande déconseillées et supprimées

Les cmdlets suivantes pour démarrer un déploiement sont déconseillées et pourraient être supprimées dans une version ultérieure :

Applets de commande déconseillés	Remplacement
Start-CMApplicationDeploymentSimulation	New-CMApplicationDeployment avec le paramètre Simulation
Start-CMClientSettingDeployment	New-CMClientSettingDeployment
Start-CMAntimalwarePolicyDeployment	New-CMAntimalwarePolicyDeployment

Les cmdlets suivantes ne sont plus disponibles, car les fonctionnalités sous-jacentes ne sont plus prises en charge :

• Add-CMApplicationCatalogWebServicePoint

• Add-CMApplicationCatalogWebsitePoint

• Get-CMApplicationCatalogWebServicePoint

• Get-CMApplicationCatalogWebsitePoint

• Remove-CMApplicationCatalogWebServicePoint

• Remove-CMApplicationCatalogWebsitePoint

• Set-CMApplicationCatalogWebsitePoint

• Get-CMVhd

• New-CMVhd

• Remove-CMVhd

• Set-CMVhd

Modifications apportées aux cmdlets

Les modifications suivantes ont été apportées aux applets de commande existantes dans cette version. Les modifications peuvent être de nouvelles fonctionnalités ou des correctifs de bogues. Certaines modifications peuvent être endommagées. Si vous utilisez l’une des applets de commande ou des fonctionnalités indiquées dans cette section, examinez attentivement les modifications pour comprendre comment elles peuvent affecter votre utilisation.

Add-CMDeviceCollectionDirectMembershipRule

Pour plus d’informations, consultez Add-CMDeviceCollectionDirectMembershipRule.

Bogues résolus

Résolution d’un problème lors de la tentative d’ajout de milliers d’appareils en tant que règles d’adhésion directe.

Add-CMDistributionPoint

Pour plus d’informations, consultez Add-CMDistributionPoint.

Dernières modifications

L’espace libre minimal par défaut est passé de 50 Mo à 500 Mo.

Add-CMTaskSequenceStep

Pour plus d’informations, consultez Add-CMTaskSequenceStep.

Changements non cassants

Suppression du paramètre superflu StepName.

Disconnect-CMTrackedObject

Pour plus d’informations, consultez Disconnect-CMTrackedObject.

Changements non cassants

Ajout de l’alias Disconnect-CMObject pour cette cmdlet.

Get-CMApplicationGroup

Pour plus d’informations, consultez la page obtenir-CMApplicationGroup.

Bogues résolus

Correction d’un problème pour obtenir le chemin correct du groupe d’applications.

Get-CMDeploymentStatusDetails

Pour plus d’informations, consultez la page obtenir-CMDeploymentStatusDetails.

Bogues résolus

Correction d’une condition de requête pour éviter un problème d’incompatibilité de type potentiel.

Import-CMAntimalwarePolicy

Pour plus d’informations, consultez Import-CMAntimalwarePolicy.

Changements non cassants

Ajout de la prise en charge de la stratégie en mode audit avec les applications potentiellement indésirables. Pour plus d’informations, consultez mode d’audit pour les applications potentiellement indésirables.

Import-CMQuery

Pour plus d’informations, consultez Import-CMQuery.

Bogues résolus

Correction d’un problème pour déverrouiller la fonction d’importation.

New-CMAdministrativeUser

Pour plus d’informations, consultez New-CMAdministrativeUser.

Bogues résolus

Correction d’un problème lorsque le nom d’utilisateur est me .

New-CMApplicationDeployment

Pour plus d’informations, consultez New-CMApplicationDeployment.

Changements non cassants

Ajout du paramètre AutoCloseExecutable pour activer le paramètre de déploiement d’application pour les comportements d’installation.

New-CMCloudManagementGateway

Pour plus d’informations, consultez New-CMCloudManagementGateway.

Dernières modifications

Le paramètre ServiceCertPassword est désormais obligatoire.

New-CMMigrationJob

Pour plus d’informations, consultez New-CMMigrationJob.

Bogues résolus

Déblocage de la migration des objets de déploiement de la distribution de logiciels.

New-CMSecondarySite

Pour plus d’informations, consultez New-CMSecondarySite.

Dernières modifications

Modification de l’espace libre minimal par défaut de 200 Mo à 500 Mo.

New-CMSoftwareUpdateAutoDeploymentRule

Pour plus d’informations, consultez New-CMSoftwareUpdateAutoDeploymentRule.

Bogues résolus

Correction d’un problème avec le paramètre Product . Lorsqu’il existe plusieurs produits portant le même nom, ils les sélectionnent à présent.

New-CMSoftwareUpdateDeployment

Pour plus d’informations, consultez New-CMSoftwareUpdateDeployment.

Changements non cassants

Ajout de l’alias Description au paramètre Comment.

New-CMTaskSequence

Pour plus d’informations, consultez New-CMTaskSequence.

Changements non cassants

• Extension de la longueur maximale du paramètre Description à 512 caractères.

• Ajout d’un nouveau paramètre HighPerformance pour prendre en charge le paramètre de performances.

• Le paramètre InstallationLicensingMode hérité a été supprimé.

• Suppression du jeu de paramètres NewInstallOSImageVhd .

• Suppression du paramètre InstallOperatingSystemImageVhd .

New-CMTaskSequenceDeployment

Pour plus d’informations, consultez New-CMTaskSequenceDeployment.

Bogues résolus

Résolution d’un problème lié aux modes de gestion de l’alimentation hautes performances.

New-CMTSStepApplyDriverPackage

Pour plus d’informations, consultez New-CMTSStepApplyDriverPackage.

Changements non cassants

Une condition a été ajoutée pour valider un package pour le PackageId spécifié.

New-CMTSStepApplyOperatingSystem

Pour plus d’informations, consultez New-CMTSStepApplyOperatingSystem.

Bogues résolus

Correction des problèmes de validation avec le paramètre DestinationVariable pour autoriser les valeurs qui commencent par un trait de soulignement (_).

Changements non cassants

Ajout du paramètre LayeredDriver pour prendre en charge le pilote de clavier superposé lors du déploiement du système d’exploitation.

New-CMTSStepUpgradeOperatingSystem

Pour plus d’informations, consultez New-CMTSStepUpgradeOperatingSystem.

Changements non cassants

Ajout d’un nouveau paramètre SoftwareUpdate pour spécifier une mise à jour de fonctionnalité pour l’étape de séquence de tâches Mettre à niveau le système d’exploitation.

Publish-CMPrestageContent

Pour plus d’informations, voir Publish-CMPrestageContent.

Bogues résolus

Correction d’un problème d’objet non valide potentiel.

Remove-CMApplicationGroup

Pour plus d’informations, consultez Remove-CMApplicationGroup.

Bogues résolus

Correction d’un problème pour obtenir le chemin correct du groupe d’applications lors de l’utilisation du pipeline.

Set-CMAntimalwarePolicy

Pour plus d’informations, consultez Set-CMAntimalwarePolicy.

Changements non cassants

Ajout du paramètre PuaProtection pour prendre en charge les applications potentiellement indésirables.

Set-CMApplicationDeployment

Pour plus d’informations, consultez Set-CMApplicationDeployment.

Changements non cassants

Ajout du paramètre AutoCloseExecutable pour activer le paramètre de déploiement d’application pour les comportements d’installation.

Set-CMClientSetting

Pour plus d’informations, consultez Set-CMClientSetting.

Changements non cassants

Ajout d’un message de dépréciation explicite pour le paramètre SoftwareMetering.

Set-CMClientSettingSoftwareUpdate

Pour plus d’informations, consultez Set-CMClientSettingSoftwareUpdate.

Changements non cassants

Ajout du paramètre EnableWsusCertPinning pour prendre en charge l’épinglage de certificat.

Set-CMDeploymentType

Pour plus d’informations, consultez Set-CMDeploymentType.

Bogues résolus

Correction d’un problème avec le paramètre AddRequirement pour ajouter de nouvelles règles.

Set-CMMsiDeploymentType

Pour plus d’informations, consultez Set-CMMsiDeploymentType.

Bogues résolus

Mise à jour du type de déploiement en fonction du type de programme d’installation pour éviter de réinitialiser les configurations quand vous changez l’emplacement du contenu.

Changements non cassants

Ajout de la prise en charge de la spécification d’un chemin de dossier au paramètre ContentLocation.

Set-CMTaskSequence

Pour plus d’informations, consultez Set-CMTaskSequence.

Changements non cassants

Ajout d’un nouveau paramètre HighPerformance pour prendre en charge les paramètres de performances de la séquence de tâches.

Set-CMTSStepApplyDriverPackage

Pour plus d’informations, consultez Set-CMTSStepApplyDriverPackage.

Changements non cassants

Une condition a été ajoutée pour valider un package pour le PackageId spécifié.

Set-CMTSStepApplyOperatingSystem

Pour plus d’informations, consultez Set-CMTSStepApplyOperatingSystem.

Bogues résolus

Correction d’un problème avec le paramètre de destination .

Changements non cassants

Ajout du paramètre LayeredDriver pour prendre en charge le pilote de clavier superposé lors du déploiement du système d’exploitation.

Set-CMTSStepUpgradeOperatingSystem

Pour plus d’informations, consultez Set-CMTSStepUpgradeOperatingSystem.

Changements non cassants

Ajout d’un nouveau paramètre SoftwareUpdate pour spécifier une mise à jour de fonctionnalité pour l’étape de séquence de tâches Mettre à niveau le système d’exploitation.

Start-CMDistributionPointUpgrade

Pour plus d’informations, consultez Start-CMDistributionPointUpgrade.

Dernières modifications

Définissez l’espace libre minimal par défaut sur 500 Mo.

Update-CMDistributionPoint

Pour plus d’informations, consultez Update-CMDistributionPoint.

Bogues résolus

Correction d’un problème de mise à jour du contenu des dossiers d’installation et de désinstallation lorsqu’ils sont différents.

Comment fournir des commentaires ou signaler des problèmes

La plupart des correctifs et améliorations décrits dans cet article sont le résultat de vos commentaires.

Pour envoyer des commentaires, utilisez la console Configuration Manager. Pour plus d’informations, consultez les commentaires pour PowerShell.

Pour envoyer de nouvelles demandes de fonctionnalités, consultez le groupe PowerShell de Configuration Manager sur uservoice.