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

  • Article

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 2103.

Notes

Configuration Manager Current Branch version 2010 est la ligne de base de ces modifications. Pour plus d’informations, consultez Configuration Manager les modifications de la bibliothèque d’applets de commande pour la version 2010.

Problème connu avec l’aide actualisable de PowerShell

À partir de la version 2010, il était possible d’utiliser la cmdlet Update-Help pour télécharger les dernières informations du module PowerShell Configuration Manager.

Dans la version 2103, la structure du module PowerShell a été remplacée par deux de 29 dll. Les fichiers d’aide XML PowerShell sont associés à la DLL pour les applets de commande. Par conséquent, le contenu de l’aide de la version 2010 est incompatible avec une console version 2103, et le contenu de l’aide de la version 2103 est incompatible avec une console version 2010.

En raison de cette modification de la structure et de la publication du contenu mis à jour avec la version 2103, n’utilisez pas Update-Help sur un site version 2010. Mettez à jour le site vers la version 2103, puis mettez à jour le contenu de l’aide locale.

La cmdlet parvient à télécharger le contenu sur une console version 2010, mais la commande Get-Help ne retourne que les informations d’utilisation par défaut. Ce comportement est dû au fait que PowerShell n’est pas en mesure de trouver les informations de cmdlet dans le bon fichier XML, ce qui est maintenant différent. Avant la sortie de la version 2103, si vous utilisiez Update-Help avec un site version 2010, vous pouvez continuer à vous servir de Get-Help maintenant.

De même, si vous avez utilisé Update-Help sur un site de version 2010, après la mise à jour vers la version 2103, exécutez à nouveau Update-Help pour obtenir la version compatible du contenu de l’aide. Sinon, la commande obtenir-Help renvoie uniquement les informations d’utilisation par défaut.

Notes

Ce problème est propre à la version 2010. En raison de la modification de la structure, cela ne devrait pas poser de problème pour les versions ultérieures.

Module PowerShell

Si la console Configuration Manager sur l’appareil n’est pas encore connectée à un site, si vous importez manuellement le module ConfigurationManager, il crée un lecteur PowerShell pour le site en fonction du fournisseur SMS par défaut.

À partir de la version 2103, le module ConfigurationManager PowerShell requiert Microsoft .NET version 4.7.2 ou ultérieure.

Applets de commande qui ne prennent pas en charge PowerShell version 7

Si les applets de commande Configuration Manager offrent une prise en charge générale de PowerShell version 7, ce n’est pas le cas des applets de commande suivantes :

  • Import-CMPackage
  • Import-CMDriverPackage
  • Import-CMTaskSequence
  • Export-CMPackage
  • Export-CMDriverPackage
  • Export-CMTaskSequence

Elles nécessitent le .NET Framework au lieu du .NET Core qui est utilisé avec PowerShell version 7.

À partir de la version 2103, si vous essayez d’utiliser ces applets de commande dans une session PowerShell version 7, elles échouent avec l’erreur suivante : This cmdlet only supports the ".NET Framework" runtime.

Nouvelles applets de commande

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, des correctifs de bogues ou la dépréciation. 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.

Prise en charge de Fast

Les applets de commande suivantes prennent désormais en charge le paramètre Fast. Utilisez ce paramètre pour ne pas actualiser automatiquement les propriétés différées. Les propriétés différées contiennent des valeurs qui sont relativement inefficaces à récupérer. L’obtention de ces propriétés peut entraîner davantage de trafic réseau et affecter les performances des applets de commande.

  • Get-CMAlert
  • Get-CMAlertSubscription
  • Get-CMBaseline
  • Get-CMBaselineDeployment
  • Get-CMBaselineDeploymentStatus
  • Get-CMClientCertificatePfx
  • Get-CMComplianceRule
  • Get-CMComplianceSetting
  • Get-CMConfigurationPlatform
  • Get-CMConfigurationPolicyDeployment
  • Get-CMDriver
  • Get-CMDriverPackage
  • Get-CMTaskSequence
  • Get-CMTaskSequenceDeployment

Add-CMFallbackStatusPoint

Changements non cassants

Correction d’un nom de paramètre incohérent.

Copy-CMCollection

Changements non cassants

Correction de la validation avec le paramètre NewName à aligner avec la console.

Get-CMDeploymentStatusDetails

Changements non cassants

  • Correction du problème de validation du type d’objet d’entrée pour des types tels que SMS_DCMDeploymentErrorStatus, SMS_DCMDeploymentNonCompliantStatus et SMS_DCMDeploymentCompliantStatus.
  • Correction du problème de type de classe non valide en modifiant le type d’objet de sortie SMS_AppDeploymentRequirementsNotMetStatus en SMS_AppDeploymentRequirementsNotMetAssetDetails.
  • Modification du type d’objet de sortie SMS_AppDeploymentAssetDetails en SMS_AppDeploymentErrorAssetDetails pour obtenir plus de détails sur l’erreur.
  • Ajout d’un type d’objet d’entrée SMS_UpdateDeploymentSummary afin que cette applet de commande puisse recevoir des détails sur le déploiement des mises à jour. Lors du passage de la sortie de CMSoftwareUpdateDeploymentStatus CMDeploymentStatusDetails, elle retourne les détails du déploiement à partir de SMS_SUMDeploymentAssetDetails.

Get-CMDriver

Changements non cassants

Ajout de la possibilité de filtrer par le paramètre AdministrativeCategory.

$category1 = Get-CMCategory -CategoryType DriverCategories -Name 'OEM 1'
$category2 = Get-CMCategory -CategoryType DriverCategories -Name 'OEM 2'
$categories = $category1,$category2

Get-CMDriver -AdministrativeCategory $categories

Get-CMPackage

Changements non cassants

Ajout du paramètre PackageType pour la récupération d’un type de package spécifique.

Get-CMSoftwareUpdateDeployment

Changements non cassants

Résolution d’un problème lors du déploiement de mises à jour sans package.

New-CMApplication

Bogues résolus

Résolution d’un problème d’affichage du centre logiciel lors de l’installation d’applications créées avec le format d’heure « aaaa/MM/jj ».

New-CMCertificateProfileScep

Bogues résolus

Résolution d’un problème pour le paramètre SanType.

New-CMCollection

Changements non cassants

Correction de la validation avec le paramètre Name à aligner avec la console.

New-CMOperatingSystemImage

Changements non cassants

Index des paramètres ajoutés. Lorsque vous ajoutez ce paramètre, le site extrait une image d’index unique à partir d’une image à plusieurs index. Il place ensuite la nouvelle image dans le même dossier source que l’image d’origine.

New-CMOperatingSystemInstaller

Changements non cassants

Index des paramètres ajoutés. Lorsque vous ajoutez ce paramètre, le site remplace l’image à plusieurs index actuelle par une nouvelle image d’index unique.

New-CMTSRule

Changements non cassants

Le paramètre ReferencedVariableOperator a une autre valeur possible : NotLike .

New-CMTSStepConditionVariable

Changements non cassants

Le paramètre OperatorType a une autre valeur possible : NotLike

New-CMSoftwareUpdateAutoDeploymentRule

Dernières modifications

Résolution d’un problème pour le paramètre O365LanguageSelection. Vous devez maintenant spécifier une langue avec un nom de pays. Cette modification aligne ce paramètre avec les options de la console Configuration Manager. Par exemple : -O365LanguageSelection "English (United States)"

Set-CMCertificateProfileScep

Bogues résolus

Résolution d’un problème pour le paramètre SanType.

Set-CMClientPushInstallation

Changements non cassants

Ajout d’un paramètre AllownNTLMFallback pour activer le secours NTLM.

Set-CMCollection

Changements non cassants

Correction de la validation avec le paramètre NewName à aligner avec la console.

Set-CMEmailProfile

Changements non cassants

  • Correction du problème avec le paramètre NewName lorsque vous spécifiez sAMAccountName comme nom d’utilisateur du compte.
  • Correction d’un problème de paramètre lors de la résolution de DomainName.

Set-CMFallbackStatusPoint

Changements non cassants

Correction d’un nom de paramètre incohérent.

Set-CMThirdPartyUpdateCatalog

Changements non cassants

Ajout des paramètres CategoryNamePublishOption et CategoryIdPublishOption. Utilisez ces paramètres pour définir l’option de publication de catégorie quand vous vous abonnez à un catalogue v3.

$id = "5768207d-6c40-465b-ad65-50501661368f"
$option = [Microsoft.ConfigurationManagement.Cmdlets.Sum.Commands.PublishOptionType]::MetadataOnly
$idOptionPair = @{$id = $option}
Set-CMThirdPartyUpdateCatalog -CatalogName 'pmp' -CategoryIdPublishOption $idOptionPair -Subscribe -Force

$name = "2BrightSparks"
$name1 = "8x8, Inc."
$option = [Microsoft.ConfigurationManagement.Cmdlets.Sum.Commands.PublishOptionType]::MetadataOnly
$nameOptionPair = @{$name = $option; $name1 = $option}
Set-CMThirdPartyUpdateCatalog -CatalogName pmp -CategoryNamePublishOption $nameOptionPair -Subscribe -Force

Set-CMThirdPartyUpdateCategory

Changements non cassants

Correction d’un problème avec le paramètre PublishOption défini sur FullContent.

Set-CMTSStep *

Par exemple, Set-CMTSStepApplyDataImage et les 34 autres cmdlets similaires.

Changements non cassants

Le paramètre OperatorType a une autre valeur possible : NotLike

Set-CMSoftwareUpdateAutoDeploymentRule

Dernières modifications

Résolution d’un problème pour le paramètre O365LanguageSelection. Vous devez maintenant spécifier une langue avec un nom de pays. Cette modification aligne ce paramètre avec les options de la console Configuration Manager. Par exemple : -O365LanguageSelection "English (United States)"

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.