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

Article
04/07/2023

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

La console Administrateur ne crée plus de lien en dur pour le module PowerShell

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

New-CMGlobalCondition et Set-CMGlobalCondition ont été remplacés par la nouvelle famille d’applets de commande de condition globale.

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

New-CMStandaloneMedia

Bogues corrigés

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.