Partager via

Modifications apportées à la bibliothèque d’applets de commande Configuration Manager pour Current Branch 1802

  • Article

Remarque

System Center Configuration Current Branch 1710 est la base de référence pour ces modifications. Pour plus d’informations, consultez Configuration Manager modifications de la bibliothèque d’applets de commande pour Current Branch 1710.

Modifications importantes

Le programme d’installation de la console Administrateur a été mis à jour pour permettre l’importation du module ConfigurationManager par nom logique sans utiliser de lien physique de <installdir>\bin\ConfigurationManager vers <installdir>\bin.

Applets de commande déconseillées

Désactiver la création automatique PSDrive

Lorsque le module ConfigurationManager.psd1 est chargé, PowerShell tente automatiquement de créer une connexion au dernier fournisseur SMS auquel vous avez accédé à l’aide de la console Configuration Manager. Dans certains scénarios, ce comportement de connexion peut ne pas être souhaitable. Une clé de Registre par utilisateur a été ajoutée qui peut désactiver ce comportement et nécessiter la création manuelle du lecteur. Pour configurer le comportement, utilisez la clé de Registre : HKEY_CURRENT_USER\Software\Microsoft\ConfigMgr10\PowerShell et définissez la valeur DisableCMDriveAutoCreate sur un DWORD de 1 (la création automatique du lecteur est désactivée) ou 0 (comportement par défaut). La suppression DisableCMDriveAutoCreate active également le comportement par défaut.

Remarque

Lorsque la création automatique du lecteur est désactivée, la console Configuration Manager peut signaler une erreur lors du lancement d’une fenêtre PowerShell.

Problèmes connus

Les éléments suivants sont des problèmes connus liés à la bibliothèque d’applets de commande qui ne sont pas résolus dans cette version.

New-CMCloudDistributionPoint

L’applet de commande n’est actuellement pas fonctionnelle.

Solution de contournement

  • Aucun

Get-CMAadConditionalAccessPolicy et Set-CMAadConditionalAccessPolicy

L’environnement PowerShell 64 bits est requis pour ces applets de commande.

Solution de contournement

  • Aucun

Import-CMSecurityRole

L’applet de commande peut échouer avec une erreur DirectoryNotFoundException qui a localisé le fichier SecuredRoles.xsd.

Solution de contournement

  • Assurez-vous que Import-Module est appelé par rapport au ConfigurationManager.psd1 fichier, et non au nom du chemin d’accès logique ou du module.

Set-CMSoftwareUpdatePoint

Les modifications apportées à Schedule peuvent ne pas s’afficher dans la console Configuration Manager même si l’objet fournisseur SMS sous-jacent a été modifié.

Solution de contournement

  • Quittez et relancez la console Configuration Manager.

Nouvelles applets de commande

Les éléments suivants sont des applets de commande récemment ajoutées pour cette version qui ajoutent de nouvelles fonctionnalités ou améliorent les fonctionnalités des applets de commande existantes.

applets de commande Co-Management

New-CMCoManagementPolicy permet la création d’une stratégie de cogestion.

Applets de commande de condition globale

De nouvelles applets de commande ont été ajoutées pour prendre en charge la création et la modification de conditions globales. Les verbes New et Set sont pris en charge.

  • CMGlobalConditionActiveDirectoryQuery
  • CMGlobalConditionAssembly
  • CMGlobalConditionFile
  • CMGlobalConditionIisMetabase
  • CMGlobalConditionRegistryKey
  • CMGlobalConditionRegistryValue
  • CMGlobalConditionScript
  • CMGlobalConditionSqlQuery
  • CMGlobalConditionWqlQuery
  • CMGlobalConditionXPathQuery
  • CMGlobalConditionOmaUri

Applets de commande de séquence de tâches

De nouvelles applets de commande ont été ajoutées pour prendre en charge la modification des étapes de séquence de tâches.

  • Commandes de séquence de tâches (Obtenir, Nouveau, Supprimer et Définir les verbes pris en charge)

    • CMTSCaptureNetworkSettings
    • CMTSCaptureSystemImage
    • CMTSCaptureUserState
    • CMTSCaptureWindowsSetting
    • CMTSConvertDisk
    • CMTSDisableBitLocker
    • CMTSEnableBitLocker
    • CMTSPrepareSmsClient
    • CMTSPrepareWindows
    • CMTSStepApplyDataImage
    • CMTSStepDownloadPackageContent
    • CMTSStepJoinDomainWorkgroup
    • CMTSStepOfflineEnableBitLocker
    • CMTSStepPrestartCheckAction
    • CMTSStepRestoreUserState
    • CMTSStepUpgradeOperatingSystem

  • Commandes de condition de séquence de tâches

    • New-CMTSStepConditionOperatingSystemLanguage applet de commande pour la création d’une condition de langue du système d’exploitation.

  • Applets de commande de copie de séquence de tâches

    • Copy-CMTaskSequence applet de commande permettant de créer une copie d’une séquence de tâches existante.

Convert-CMDeploymentType

Cette applet de commande permet d’obtenir un objet natif DeploymentType à partir d’une instance d’objet SMS_DeploymentType WMI. Peut être combiné avec Get-CMDeploymentType.

Suivi et récupération des ressources (BETA)

De nouvelles applets de commande ont été ajoutées pour prendre en charge le suivi des objets du fournisseur SMS utilisés par le runtime PowerShell et pour nettoyer ces ressources lorsqu’elles ne sont plus nécessaires.

  • Disconnect-CMTrackedObject
  • Start-CMObjectTracking
  • Stop-CMObjectTracking

Quand Start-CMObjectTracking est exécuté, le runtime PowerShell effectue le suivi des IResultObject objets créés par les applets de commande de la bibliothèque d’applets de commande. Les applets de commande qui ne sont pas nettoyées manuellement avec .Dispose() peuvent être récupérées à l’aide Disconnect-CMTrackedObject d’un objet individuel.

Exemple

# Reclaim all tracked objects
$o | Disconnect-CMTrackedObject```), or ```Disconnect-CMTrackedObject -All

Une fois qu’un objet est récupéré, il ne peut plus être réutilisé ou passé à une autre applet de commande via le pipeline d’objets.

Stop-CMObjectTracking peut être utilisé pour désactiver le suivi des objets. Les objets précédemment alloués restent actifs.

Les ressources non réclamées peuvent entraîner le génération d’erreurs de violation de quota par le fournisseur SMS. Ces problèmes de quota se manifestent généralement par l’utilisation de grands ensembles d’objets fournisseur SMS ou dans des environnements de longue durée.

Remarque

Il s’agit d’une fonctionnalité expérimentale qui peut être modifiée ou supprimée dans une version ultérieure. Cette fonctionnalité est activée par défaut.

Modifications des applets de commande

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

PowerShell ISE

Bogues corrigés

Powershell_ise.exe processus peut se bloquer à la sortie lorsque la journalisation détaillée est activée globalement et que le module ConfigurationManager a été importé.

Applets de commande de séquence de tâches

Bogues corrigés

  • New-CMTSRule
    • L’applet de commande peut échouer si un SecureString type de variable est utilisé.
  • New-CMTSStepApplyOperatingSystem et Set-CMTSStepApplyOperatingSystem
    • Impossible de spécifier une valeur Null pour DestinationLogicalDrive.
    • La valeur en minuscules de DestinationLogicalDrive peut entraîner un échec de validation de l’interface utilisateur.
  • New-CMTSStepApplyWindowsSetting et Set-CMTSStepApplyWindowsSetting
    • L’utilisation des paramètres de mot de passe peut provoquer une erreur dans le fournisseur SMS.
  • New-CMTSStepInstallSoftware et Set-CMTSStepInstallSoftware
    • L’applet de commande autorise incorrectement la combinaison des paramètres Program et EnableContinueOnInstallError .

Modifications non cassants

Amélioration de la validation des paramètres.

Add-CMComplianceSettingRegistryKeyValue

Bogues corrigés

ExpressionValue ne prend pas en charge toutes les combinaisons de paramètres avec ExpressionOperator. Corrigez le comportement non cohérent avec la console administrateur.

Modifications non cassants

Ajout du paramètre RemediateDword pour prendre en charge une valeur entière pour la correction.

Add-CMManagementPoint

Modifications non cassants

Amélioration de la validation des paramètres.

Add-CMMsiDeploymentType

Bogues corrigés

L’applet de commande ne valide pas l’utilisation correcte des combinaisons de paramètres UninstallContentLocation et UninstallOption .

Add-CMScriptDeploymentType

Bogues corrigés

L’applet de commande nécessite l’utilisation incorrecte du paramètre Script lors de l’utilisation de AddDetectionClause.

Add-CMSoftwareUpdatePoint

Bogues corrigés

L’applet de commande peut retourner une erreur lors de l’ajout d’un point de mise à jour logicielle à un système distant.

Enable-CMSiteFeature

Bogues corrigés

Si les fonctionnalités de préversion ne sont pas activées pour la hiérarchie, l’applet de commande échoue avec un message d’erreur mis en forme incorrectement.

Get-CMApplication

Changements cassants

Les applications masquées ne sont plus incluses par défaut. Le paramètre ShowHidden a été ajouté pour forcer l’affichage des applications masquées dans le jeu de résultats.

Get-CMSiteInstallStatus

Bogues corrigés

L’applet de commande peut exécuter une requête non valide sur le fournisseur SMS.

Get-CMSiteStatusMessage

Bogues corrigés

La requête de message d’état peut retourner des messages en double.

New-CMBootableMedia

Bogues corrigés

Le paramètre DistributionPoint n’ignore pas les points de distribution cloud.

New-CMComplianceRuleFileFolderSize

Modifications non cassants

Amélioration de la validation des paramètres.

New-CMDetectionClauseMacPackage

Bogues corrigés

Amélioration de la validation des paramètres.

New-CMDetectionClauseWindowsInstaller

Bogues corrigés

La valeur ProductCode n’est pas correctement appliquée à l’objet Setting.

New-CMExchangeServer

Modifications non cassants

Les paramètres FullSyncSchedule ou DeltaSyncMins ne sont plus obligatoires et appliquent une planification par défaut s’ils ne sont pas utilisés.

New-CMInventoryReportClass**

Modifications non cassants

Ajout du paramètre Name pour définir le nom de la classe.

New-CMPrestagedMedia

Bogues corrigés

L’applet de commande échoue lors de la spécification d’un fichier de sortie avec une extension .wim.

New-CMProgram

Bogues qui ont été déposés

La valeur du paramètre ProgramRunType peut être appliquée de manière incorrecte à Program.

New-CMSchedule

Bogues corrigés

RecurCount ne doit pas autoriser la valeur .0

New-CMStandaloneMedia

Bogues corrigés

La création d’un média par l’applet de commande peut échouer si MediaType a la valeur Usb.

Modifications non cassants

Amélioration de la validation des paramètres.

New-CMStatusFilterRule

Modifications non cassants

Amélioration de la validation des paramètres.

New-CMStorageFolder

Modifications non cassants

Amélioration de la validation des paramètres.

New-CMTaskSequenceDeployment

Bogues corrigés

L’applet de commande peut ajouter deux planifications lorsque ScheduleEvent est utilisé.

New-CMWirelessProfile

Modifications non cassants

Amélioration de la validation des paramètres.

Publish-CMPrestageContent

Bogues corrigés

Application/Applicationname/ L’utilisation du paramètre ApplicationId peut entraîner l’échec de l’applet de commande.

Modifications non cassants

Améliorations des performances.

Set-CMAntimalwarePolicy

Bogues corrigés

AddExcludedFilePath ne crée pas de règles d’exclusion par défaut.

Set-CMApplication

Bogues corrigés

La modification d’une application avec plusieurs langues d’affichage peut entraîner des modifications inattendues de l’état de l’application.

Modifications non cassants

Les paramètres AddAppCategory, AddUserCategory, RemoveAppCategory, RemoveUserCategory, CleanAppCategory et CleanUserCategory ont été ajoutés pour prendre en charge l’ajout de catégories d’application par objet.

Dépréciations

Les paramètres AppCategory et UserCategory ont été remplacés par le nouveau [Ajouter| Supprimer | Nettoyer]AppCategory et [Ajouter| Supprimer | Clean]Paramètres UserCategory.

Set-CMBoundary

Bogues corrigés

Le paramètre NewName est manquant.

Modifications non cassants

Amélioration de la validation des paramètres.

Set-CMClientSettingClientcache

Dépréciations

Le paramètre EnableHttps n’est plus pris en charge.

Set-CMManagementPoint

Modifications non cassants

Amélioration de la validation des paramètres.

Set-CMMsiDeploymentType

Bogues corrigés

L’applet de commande ne valide pas l’utilisation correcte des combinaisons de paramètres UninstallContentLocation et UninstallOption .

Set-CMPackage

Bogues corrigés

Le paramètre UseMeteredNetwork est manquant.

Set-CMSoftwareInventory

Modifications non cassants

Paramètres CleanTag1, CleanTag2 et CleanTag3 ajoutés pour prendre en charge la suppression des balises.

Paramètres ParentSoftwareId et CategoryId ajoutés.

Amélioration de la validation des paramètres.

Set-CMStatusFilterRule

Modifications non cassants

Amélioration de la validation des paramètres.

Set-CMUserDataAndProfileConfigurationItem

Modifications non cassants

Amélioration de la validation des paramètres.

Set-CMWirelessProfile

Modifications non cassants

Amélioration de la validation des paramètres autour de différents scénarios de création de profil.