Partager via

Modifications apportées à la bibliothèque d’applets de commande Configuration Manager pour la version 1902

  • Article

S’applique à : Gestionnaire de configuration (branche actuelle)

Remarque

Configuration Manager current branch version 1810 est la base de référence pour ces modifications. Pour plus d’informations, consultez Configuration Manager modifications apportées à la bibliothèque d’applets de commande pour la version 1810.

Modifications importantes

Nouvelles applets de commande

Get-CMBoundaryGroupSiteSystem

Utilisez cette applet de commande pour obtenir le système de site dans le groupe de limites spécifié.

Get-CMBoundaryGroupSiteSystem -Id $boundaryGroup.GroupID

Get-CMDistributionPointDriveInfo

Utilisez cette applet de commande pour obtenir des informations sur le lecteur de point de distribution.

$dp = Get-CMDistributionPoint -SiteSystemServerName $ReferenceSiteSystemServerName 
$dp | Get-CMDistributionPointDriveInfo

Invoke-CMAnalyzePackage

Utilisez cette applet de commande pour analyser un package spécifique.

Invoke-CMAnalyzePackage -PackageName $packageName

Invoke-CMConvertPackage

Utilisez cette applet de commande pour convertir un package spécifique en application.

Invoke-CMConvertPackage -PackageName $packageName

New-CMScript

Utilisez cette applet de commande pour créer un script PowerShell. Il prend uniquement en charge les scripts qui ne contiennent aucun paramètre.

New-CMScript -ScriptName "CMScript" -ScriptText 'Write-Host "New Script"'
New-CMScript -ScriptName "ImportScript" -ScriptFile \\abc\importedscript.ps1

Set-CMClientSettingDeliveryOptimization

Utilisez cette applet de commande pour définir les paramètres du client pour la fonctionnalité d’optimisation de la distribution.

[Default] Set-CMClientSettingDeliveryOptimization -DefaultSetting -Enable $true
[Customized] Set-CMClientSettingDeliveryOptimization -Name $ReferenceClientDeviceSettingName -Enable $true

Set-CMClientSettingWindowsAnalytics

Utilisez cette applet de commande pour définir les paramètres du client pour la fonctionnalité Windows Analytics.

[Default] Set-CMClientSettingWindowsAnalytics -DefaultSetting -Enable $true -CommercialIdKey $commercialIdKey -Win10Telemetry EnhancedLimited -EnableEarlierTelemetry $true -IEDataCollectionOption AllZones
[Customized] Set-CMClientSettingWindowsAnalytics -Name $ReferenceClientDeviceSettingName -Enable $true -CommercialIdKey $commercialIdKey -Win10Telemetry EnhancedLimited -EnableEarlierTelemetry $true -IEDataCollectionOption AllZones

Applets de commande supprimées

Aucun

Applets de commande déconseillées

Aucun

Problèmes connus

Les éléments suivants sont des 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

Ces applets de commande nécessitent un environnement PowerShell 64 bits.

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

  • Appelez Import-Module le ConfigurationManager.psd1 fichier, et non le chemin logique ou le nom 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.

Suivi et récupération des ressources (bêta)

Cette version ajoute de nouvelles applets de commande 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

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

Exemple

# Reclaim a single tracked object
$o | Disconnect-CMTrackedObject

# Reclaim all tracked objects
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 fournisseur SMS à déclencher des erreurs de violation de quota. Ces problèmes de quota se manifestent généralement par l’utilisation d’ensembles volumineux d’objets fournisseur SMS ou dans des environnements de longue durée.

Remarque

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

Modifications des applets 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. 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.

Add-CMDeviceAffinityToUser

Bogues corrigés

  • Add/Remove-CMDeviceAffinityToUser -UserId/-UserName doit utiliser « -DeviceId/-DeviceName » ensemble.

Modifications non cassants

  • Ajout de la vérification des paramètres pour -DeviceID et -DeviceName, l’utilisateur doit spécifier au moins l’un d’entre eux.

Add-CMDeviceCollectionDirectMembershipRule

Bogues corrigés

  • Lorsque la même ressource est ajoutée à la même collection à l’aide de la commande « Add-CMDeviceCollectionDirectMembershipRule » dans PowerShell, elle affiche un avertissement vide « AVERTISSEMENT : » et ne génère pas l’erreur « Un objet portant le nom spécifié existe déjà ».

Modifications non cassants

  • Ajout d’une ressource manquante.

Add-CMDistributionPoint

Modifications non cassants

  • Ajout du paramètre « -EnableLedbat » pour activer/désactiver LEDBAT sur dp

Add-CMScriptDeploymentType

Bogues corrigés

  • Add-CMScriptDeploymentType pas l’interface utilisateur par défaut

Modifications non cassants

  • Modification du code d’initialisation pour l’aligner sur l’interface utilisateur (Durée d’installation estimée = 0, condition d’ouverture de session =uniquement lorsqu’un utilisateur est connecté).

Approve-CMApprovalRequest

Modifications non cassants

  • Ajout du nouveau paramètre InstallActionBehavior (a deux options : InstallNow, InstallNonBusinessHours). L’administrateur peut spécifier s’il faut installer l’application immédiatement après son approbation ou si elle doit être installée pendant les heures non ouvrées. Il s’agit d’un paramètre facultatif et, par défaut, il est égal à « InstallNow ».

Get-CMDevice

Bogues corrigés

  • Get-CMDevice propriété SMSAssignedSites est manquante : elle était disponible avant la version 1806.

Modifications non cassants

  • Ajout de deux nouveaux paramètres de commutateur pour permettre au client de spécifier la classe de la sortie :

    • -ReturnCollectionMember : force l’instance de retour de la classe membre de la collection sms
    • -ReturnResource : force l’instance de retour de SMS_Resource classe.

    Si vous utilisez le paramètre par défaut sans ReturnCollectionMember/ReturnResource, le comportement serait le même que 1802/1810 : l’instance retournée peut se trouver dans différentes classes avec des paramètres spécifiés différents.

Get-CMPackage

Bogues corrigés

  • Get-CMPackage a besoin d’un commutateur -Fast

Modifications non cassants

  • Ajout du paramètre -Fast pour prendre en charge la requête rapide.

Import-CMDriver

Bogues corrigés

  • Set-CMDriver -SupportedPlatformName échoue pour les tableaux

Modifications non cassants

  • Correction d’un problème de valeur de tableau pour le paramètre SupportPlatformName.

Invoke-CMScript

Bogues corrigés

  • Invoke-CMScript applet de commande attend un objet qui ne peut pas être obtenu.

Modifications non cassants

  • Correction de la validation du type.

New-CMActiveDirectoryForest

Bogues corrigés

  • Création d’une forêt Active Directory : l’utilisateur ne fonctionne pas via PowerShell, uniquement s’il est créé via l’interface graphique utilisateur.

Modifications non cassants

  • Importé le compte dans le compte global après que l’utilisateur a défini les informations d’identification.
  • Ajout du nouveau paramètre -Password pour la création d’informations d’identification avec mot de passe.

New-CMApplication

Bogues corrigés

  • L’utilisateur ne peut pas spécifier un paramètre Owner ou SupportContact vide avec l’applet de commande New-CMApplication

Modifications non cassants

  • Autorisez $null pour Owner/SupportContact lors de la création d’une application, la valeur par défaut est l’utilisateur actuel.
  • Ajout de nouveaux paramètres pour Owner/SupportContact pour prendre en charge l’entrée de tableau.

New-CMApplicationDeployment

Modifications non cassants

  • Ajout du nouveau paramètre ReplaceToastNotificationWithDialog (Boolean). L’administrateur peut spécifier s’il faut remplacer les notifications toast par une boîte de dialogue lorsque le logiciel requis devient disponible sur l’ordinateur client. Il s’agit d’un paramètre facultatif et false par défaut.

New-CMCoManagementPolicy

Modifications non cassants

  • Ajout de la prise en charge des nouvelles charges de travail (DCWorkloadEnabled, O365WorkloadEnabled, ClientAppsWorkloadEnabled).

New-CMDetectionClauseWindowsInstaller

Bogues corrigés

  • Add/Set-CMMsiDeploymentType -AddDetectionClause a échoué « Expression non valide : le type de données de l’opérande ne correspond pas ou l’opérateur n’est pas valide pour le type de données ».

Modifications non cassants

  • Modification de la logique de l’initialisation du type de données pour vous assurer qu’elle est correcte lorsque vous spécifiez le commutateur Existence.

New-CMOperatingSystemImageUpdateSchedule

Modifications non cassants

  • Nouveau paramètre ajouté pour correspondre aux modifications apportées à l’Assistant Création de planification dans l’interface utilisateur :
    • -RemoveSupersededUpdates

New-CMOperatingSystemUpgradeUpdateSchedule

Modifications non cassants

  • Nouveau paramètre ajouté pour correspondre aux modifications apportées à l’Assistant Création de planification dans l’interface utilisateur :
    • -RemoveSupersededUpdates

New-CMPackageDeployment

Bogues corrigés

  • New-CMPackageDeployment a des avertissements incohérents

Modifications non cassants

  • Modification du comportement par défaut de l’option SlowNetwork pour l’aligner sur l’interface utilisateur.

New-CMStatusFilterRule

Bogues corrigés

  • New-CMStatusFilterRule ne fonctionne pas comme prévu
  • Impossible de créer une règle de filtre d’état avec la propriété « ID de package.

Modifications non cassants

  • Ajout d’une condition supplémentaire pour la vérification de l’ID de propriété/valeur pour débloquer la casse sans -PropertyID spécifié.
  • Ajout d’une logique pour autoriser l’id de propriété de jeu d’utilisateurs = 'PACKAGE ID' lorsque la source est 'Client'.

New-CMTaskSequenceDeployment

Bogues corrigés

  • Impossible de définir l’heure d’expiration d’un déploiement de séquence de tâches
  • New-CMTaskSequenceDeployment , $result ne peut pas obtenir l’objet à partir de cette applet de commande.

Modifications non cassants

  • Ajout de l’alias « DeploymentExpireDateTime » au paramètre -DeadlineDateTime pour s’aligner sur l’applet de commande Set.
  • Suppression du bloc using, l’objet de déploiement ne doit pas être supprimé.

New-CMTaskSequenceMedia

Modifications non cassants

  • Un nouveau paramètre ajouté pour correspondre aux modifications ajoutées à l’interface utilisateur de création de média de séquence de tâches :
    • -TemporaryFolder (alias « TemporaryDirectory », « StagingArea »)

New-CMTSStepRunPowerShellScript

Changements cassants

  • Jeux de paramètres ajoutés : RunScriptFromSource, RunScriptFromPackage.
  • Les paramètres PackageID et PackageName ne sont plus obligatoires, car les utilisateurs peuvent également entrer un nouveau paramètre SourceScript

Modifications non cassants

  • Nouveaux paramètres ajoutés pour correspondre aux modifications apportées à l’étape Exécuter le script Power Shell dans l’interface utilisateur de l’éditeur de séquence de tâches :
    • -SourceCode
    • -WorkingDirectory
    • -OutputVariableName
    • -Timeout
    • -Nom d'utilisateur
    • -Mot de passe
    • -SuccessCodes

Remove-CMDeviceAffinityFromUser

Bogues corrigés

  • Add/Remove-CMDeviceAffinityToUser -UserId/-UserName doit utiliser « -DeviceId/-DeviceName » ensemble.

Modifications non cassants

  • Ajout de la vérification des paramètres pour -DeviceID et -DeviceName, l’utilisateur doit spécifier au moins l’un d’entre eux.

Set-CMActiveDirectoryForest

Bogues corrigés

  • Création d’une forêt Active Directory : l’utilisateur ne fonctionne pas via PowerShell, uniquement s’il est créé via l’interface graphique utilisateur.

Modifications non cassants

  • Importé le compte dans le compte global après que l’utilisateur a défini les informations d’identification.
  • Ajout du nouveau paramètre -Password pour la création d’informations d’identification avec mot de passe.

Set-CMApplicationDeployment

Modifications non cassants

  • Ajout du nouveau paramètre ReplaceToastNotificationWithDialog (Boolean). L’administrateur peut spécifier s’il faut remplacer les notifications toast par une boîte de dialogue lorsque le logiciel requis devient disponible sur l’ordinateur client. Il s’agit d’un paramètre facultatif et false par défaut.

Set-CMClientSetting

Modifications non cassants

  • Ajout du nouveau paramètre ReplaceToastNotificationWithDialog (Boolean), l’administrateur peut spécifier s’il faut remplacer les notifications toast par une boîte de dialogue lorsque l’ordinateur nécessite un redémarrage. Il s’agit d’un paramètre facultatif et false par défaut.

Set-CMClientSettingComputerRestart

Modifications non cassants

  • Ajout du nouveau paramètre ReplaceToastNotificationWithDialog (Boolean), l’administrateur peut spécifier s’il faut remplacer les notifications toast par une boîte de dialogue lorsque l’ordinateur nécessite un redémarrage. Il s’agit d’un paramètre facultatif et false par défaut.

Set-CMComplianceRuleExistential

Bogues corrigés

  • Set-CMComplianceRuleExistential -La règle ne fonctionne pas pour définir la valeur de la règle.
  • Set-CMComplianceRuleExistential -ExpectedValue n’autorisent pas définir sur un nombre négatif, sans sélectionner le paramètre [-Existence Occurs] qu’il a correctement défini.

Modifications non cassants

  • Modification de la fonction WarnIgnoredParameter pour s’assurer qu’elle appelait IsBoundParameterUsed avec le paramètre silent='true' pour éviter toute erreur de blocage lorsque l’applet de commande enfant remplace le paramètre de base comme paramètre non public.
  • Déplacement de la validation du résultat attendu vers un emplacement commun.

Set-CMDiscoveryMethod

Bogues corrigés

  • Set-CMDiscoveryMethod n’a pas de paramètre pour configurer le compte de découverte.

Modifications non cassants

  • Ajout du nouveau paramètre -UserName pour spécifier le compte de découverte pour l’ajout d’ADContainer pour ad system/user discovery.

Set-CMDistributionPoint

Modifications non cassants

  • Ajout du paramètre « -EnableLedbat » pour activer/désactiver LEDBAT sur dp

Set-CMDriver

Bogues corrigés

  • Set-CMDriver -SupportedPlatformName échoue pour les tableaux

Modifications non cassants

  • Correction d’un problème de valeur de tableau pour le paramètre SupportPlatformName.
  • Ajout de nouveaux paramètres pour SupportedPlatform : -AddSupportedPlatformName; -RemoveSupportedPlatformName ; -ClearSupportedPlatform

Dépréciations

  • Paramètre déconseillé : -SupportedPlatformName

Set-CMManagementPoint

Changements cassants

  • Modification de la validation du paramètre pour l’aligner sur l’interface utilisateur, ajout de code pour réinitialiser le type de connexion client lors de l’activation/désactivation de la passerelle cloud. Il s’agit d’un changement cassant, car nous bloquerions l’utilisateur pour activer la passerelle cloud (-EnableCloudGateway) sans SSL.

Bogues corrigés

  • Set-CMManagementPoint -EnableCloudGateway, définissez d’abord MP sur HTTPS/EnableCloudGateway true, puis affectez à MP la valeur HTTP. EnableCloudGateway ne doit pas être vérifié.

Set-CMStatusFilterRule

Bogues corrigés

  • Set-CMStatusFilterRule ne fonctionne pas avec la définition de l’ID de package

Modifications non cassants

  • Autoriser l’utilisateur à définir la propriété sans spécifier à nouveau la source, la différence avec l’interface utilisateur est que nous avons besoin de l’utilisateur pour spécifier -PropertyID et -PropertyValue ensemble.
  • Ajout de code pour éviter le message d’avertissement vide lorsque l’objet n’existe pas.

Set-CMTSStepRunPowerShellScript

Modifications non cassants

  • Nouveaux paramètres ajoutés pour correspondre aux modifications apportées à l’étape Exécuter le script Power Shell dans l’interface utilisateur de l’éditeur de séquence de tâches :
    • -SourceCode
    • -WorkingDirectory
    • -OutputVariableName
    • -Timeout
    • -Nom d'utilisateur
    • -Mot de passe
    • -SuccessCodes

Set-CMWindowsFirewallPolicy

Bogues corrigés

  • Set/Remove-CMWindowsFirewallPolicy -InputObject doit entrer le type correct à partir de New-CMWindowsFirewallPolicy.

Modifications non cassants

  • Correction de la validation du type.