Partager via

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

  • Article

Remarque

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

Modifications importantes

Mises à jour de la bibliothèque de documentation

Pour obtenir la documentation la plus récente de la bibliothèque d’applets de commande, consultez Informations de référence sur le module ConfigurationManager.

Applets de commande supprimées

Les applets de commande suivantes ne sont plus prises en charge et ont été supprimées :

  • Invoke-CMAmtProvisioningDiscovery
  • New-CMAmtProvisioningAccount
  • Set-CMPowerControl

Applets de commande déconseillées

  • Invoke-CMEndpointProtectionScan et Save-CMEndpointProtectionDefinition ont été remplacés par Invoke-CMClientAction.

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 accessible à l’aide de la console Configuration Manager. Dans certains scénarios, ce comportement 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 cela, utilisez la clé de Registre et HKEY_CURRENT_USER\Software\Microsoft\ConfigMgr10\PowerShell 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

Il s’agit de problèmes connus avec la bibliothèque d’applets de commande qui ne sont pas résolus dans cette version.

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

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

Get-CMSiteUpdateInstallStatus

L’applet de commande peut échouer avec une erreur WqlQueryException.

Solution de contournement

  • Utilisez Invoke-CMWmiQuery pour interroger directement la classe SMS_CM_UpdatePackTopLevelMonitoring.
Exemple
# Note: The PackageGuid value can be determined by running Get-CMSiteUpdateInstallStatus -Verbose and viewing the query details.
Invoke-CMWmiQuery "SELECT * FROM SMS_UpdatePackTopLevelMonitoring WHERE PackageGuid='...' ORDER BY StageId ASC"

Set-CMSoftwareUpdatePoint

Les modifications apportées à Schedule peuvent ne pas être répercutées 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

Il s’agit d’applets de commande nouvellement 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 d’association d’appareils

Get-CMResultantCollection obtient les regroupements associés à un appareil. Get-CMResultantDeployment obtient les déploiements ciblés sur un appareil.

Gestion des classes d’inventaire client

De nouvelles applets de commande ont été ajoutées pour prendre en charge la modification des classes d’inventaire utilisées pour l’inventaire client.

  • Get-CMInventoryClass
  • New-CMInventoryReportClass

Séquences 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)
    • CMTaskSequenceStepApplyOperatingSystem
    • CMTaskSequenceStepApplyWindowsSetting

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 en utilisant Disconnect-CMTrackedObject sur un objet individuel.

Exemple

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

Notez qu’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. Notez que 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 se manifestent généralement par l’utilisation d’ensembles très volumineux d’objets fournisseur SMS ou dans des environnements très longs

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, et peuvent être rompues. 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.

Paramètres de conformité et applets de commande de règle

Bogues corrigés

La valeur RuleDescription peut ne pas s’appliquer à la règle. (Applets de commande qui prennent en charge la création ou la modification de règles)

Impossible de définir la valeur de la clé de Registre « par défaut » (Add/Set-CMComplianceSettingRegistryKeyValue, New-CMDetectionClauseRegistryKeyValue).

NullReferenceException peut être déclenché (New-CMComplianceRuleAssembly)

Prise en charge de DataType manquant (Add-CMComplientSettingREgistryKeyValue)

Add-CMApplicationCatalogWebsitePoint

Bogues corrigés

Amélioration de la gestion et de la création de rapports d’erreurs.

Add/Set-CMDataWarehouseServicePoint

Modifications non cassants

DataWarehouseSqlPort prend en charge la valeur de port comprise entre 1 et 65535. Le paramètre DaysOfWeek prend désormais en charge la valeur de Daily.

Add/Set-CMExchangeServer

Bogues corrigés

La valeur du paramètre EmailAddress peut ne pas s’appliquer à la configuration du serveur Exchange.

Add-CMMsiDeploymentType

Bogues corrigés

Le paramètre ContentLocation est requis lors de l’utilisation de la détection de script. Ajout de nouveaux paramètres UninstallContentLocation et UninstallOption .

Modifications non cassants

Amélioration de la validation du paramètre ProductCode .

Add-CMScriptDeploymentType

Modifications non cassants

Amélioration de la validation du paramètre ProductCode . Ajout de nouveaux paramètres UninstallContentLocation et UninstallOption .

Get-CMDeploymentTypeDependencyGroup

Modifications non cassants

L’applet de commande prend désormais en charge la valeur de pipeline à partir de Get-CMDeploymentType.

Get-CMSiteStatusMessage

Bogues corrigés

Tous les messages ne sont pas retournés lors du filtrage avec le paramètre Gravité .

Invoke-CMClientAction (anciennement Invoke-CMClientNotification)

Modifications non cassants

Paramètre ActionType qui accepte tous les types de notification client.

Remarque

RequestScriptExecution n’est pas pris en charge pour l’instant.

Dépréciations

NotificationType a été remplacé par ActionType

New-CM*Deployment

Bogues corrigés

L’applet de commande permet de combiner les paramètres CollectionId, CollectionName et Collection , ce qui peut entraîner un comportement non défini.

New-CMBootableMedia

Bogues corrigés

Impossible de créer un média en tant que SiteBased.

New-CMWirelessProfile

Bogues corrigés

L’exécution de l’applet de commande échoue dans un environnement PowerShell 64 bits.

L’applet de commande peut retourner une erreur si vous spécifiez une valeur pour le paramètre ClientCertificate .

Remove-CMCorpOwnedDevice

Bogues corrigés

Impossible de supprimer l’appareil lors de l’utilisation d’un objet pipeline.

Le nom de l’appareil n’est pas signalé lors de l’utilisation de WhatIf ou Confirm.

Remove-CMStateMigrationPoint

Changements cassants

Une confirmation supplémentaire sera nécessaire si des données utilisateur sont stockées sur le point de migration d’état. Remarque : Forcer ignorera cette confirmation.

Save-CMSoftwareUpdate

Modifications non cassants

Ajout des paramètres RetryCount et RetryDelaySec pour retenter les téléchargements après un échec.

Set-CMAccessAccount

Bogues corrigés

PassThru peut ne pas retourner d’objet mis à jour.

Set-CMAntimalwarePolicy

Bogues corrigés

Impossible d’utiliser des caractères génériques avec le paramètre AddExcludedFilePath .

Impossible de configurer FallbackOrder pour une stratégie donnée

Modifications non cassants

Ajout de nouveaux paramètres pour la gestion des listes de menaces : AddThreat, RemoveThreat et CleanThreat. AddThreat accepte une table de hachage avec la clé étant le nom et la valeur de type Microsoft.ConfigurationManagement.Cmdlets.EP.Commands.DefaultActionMediumAndLowType.

Dépréciations

Les paramètres ThreatName et OverrideAction ont été remplacés par AddThreat, RemoveThreat et CleanThreat.

Set-CMClientSettingComputerAgent

Dépréciations

Paramètre HealthAttestationUrl , car il n’est plus utilisé par le produit.

Set-CMClientSettingHardwareInventory

Modifications non cassants

Les paramètres AddInventoryReportClass, CleanInventoryReportClass et RemoveInventoryReportClass prennent en charge la modification de l’inventaire matériel collecté par les clients.

Set-CMMsiDeploymentType

Modifications non cassants

Amélioration de la validation du paramètre ProductCode .

Set-CMScriptDeployment

Bogues corrigés

L’objet d’application dans le fournisseur SMS peut ne pas se déverrouiller automatiquement si l’applet de commande échoue, empêchant d’autres modifications jusqu’à l’expiration du verrou.

Set-CMScriptDeploymentType

Modifications non cassants

Amélioration de la validation du paramètre ProductCode .

Set-CMSoftwareUpdatePointComponent

Modifications non cassants

Ajout du nouveau paramètre ContentFileOption pour la configuration du comportement de téléchargement des mises à jour.

Set-CMSiteMaintenanceTask

Modifications non cassants

Amélioration du rapport d’erreurs

Set-CMWirelessProfile

Bogues corrigés

L’exécution de l’applet de commande échoue dans un environnement PowerShell 64 bits.

L’erreur Non correspondancePSTypeName peut être déclenchée lors de l’utilisation du pipeline d’objets.

ProxyAddress et ProxyPort ne valident pas l’utilisation des mêmes règles que la console Configuration Manager.

La spécification de ProxyAddress sans ProxyPort peut entraîner la création d’une configuration non valide.

SecurityAuthentication peut être modifié avec des configurations qui ne le prennent pas en charge.

EapType doit être combiné avec SecurityAuthentication même lorsque cette dernière ne change pas.

Modifications non cassants

Ajout des paramètres RootCertificate, ClientCertificate et RememberCredentials .

Amélioration des fonctionnalités de configuration d’une stratégie sans fil MSCHAPv2.

Sync-CMSoftwareUpdate

Modifications non cassants

L’applet de commande ne nécessite plus de paramètres à spécifier.

Remarque

Lorsqu’aucun paramètre n’est défini, -ForceSync $true est implicite.