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

S’applique à : Configuration Manager (branche actuelle)

Ces notes de publication résument les modifications apportées à la bibliothèque d’applets de commande Configuration Manager dans la version 2103.

Remarque

Configuration Manager current branch version 2010 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 2010.

Problème connu avec l’aide de PowerShell pouvant être mise à jour

À compter de la version 2010, vous pouvez utiliser l’applet de commande Update-Help pour télécharger les dernières informations du module PowerShell Configuration Manager.

Dans la version 2103, la structure du module PowerShell est passée de 29 DLL à deux. Les fichiers d’aide XML PowerShell sont associés à la DLL pour les applets de commande. Par conséquent, le contenu d’aide de la version 2010 n’est pas compatible avec une console version 2103, et le contenu d’aide de la version 2103 n’est pas compatible avec une console version 2010.

En raison de ce changement dans la façon dont le contenu pouvant être mis à jour est structuré et publié 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.

L’applet de commande télécharge correctement le contenu sur une console version 2010, mais Get-Help retourne uniquement les informations d’utilisation par défaut. Ce comportement est dû au fait que PowerShell n’est pas en mesure de trouver les informations d’applet de commande dans le fichier XML approprié, ce qui est maintenant différent. Avant la publication de la version 2103, si vous utilisiez Update-Help avec un site version 2010, vous pouvez continuer à utiliser Get-Help maintenant.

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

Remarque

Ce problème est propre à la version 2010. En raison de la façon dont la structure a changé, cela ne devrait pas être un 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.

À compter de la version 2103, le module PowerShell ConfigurationManager nécessite Microsoft .NET version 4.7.2 ou ultérieure.

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

Bien que les applets de commande Configuration Manager fournissent une prise en charge générale de PowerShell version 7, les applets de commande suivantes ne prennent pas en charge PowerShell 7 :

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

Ils nécessitent le .NET Framework au lieu de .NET Core utilisé avec PowerShell version 7.

À compter 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 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.

Prise en charge rapide

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

Modifications non cassants

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

Copy-CMCollection

Modifications non cassants

Correction de la validation avec le paramètre NewName pour l’aligner sur la console.

Get-CMDeploymentStatusDetails

Modifications non cassants

  • Correction d’un problème de validation de type d’objet d’entrée pour des types tels que SMS_DCMDeploymentErrorStatus, SMS_DCMDeploymentNonCompliantStatus et SMS_DCMDeploymentCompliantStatus.
  • Correction d’un problème de type de classe non valide de sortie en remplaçant le type d’objet de sortie SMS_AppDeploymentRequirementsNotMetStatus par SMS_AppDeploymentRequirementsNotMetAssetDetails.
  • Modification du type d’objet de sortie de 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 obtenir les détails du déploiement de mise à jour. Lorsque vous transmettez la sortie de Get-CMSoftwareUpdateDeploymentStatus à Get-CMDeploymentStatusDetails, elle retourne les détails de déploiement de SMS_SUMDeploymentAssetDetails.

Get-CMDriver

Modifications non cassants

Ajout de la possibilité de filtrer par 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

Modifications non cassants

Ajout du paramètre PackageType pour récupérer un type de package spécifique.

Get-CMSoftwareUpdateDeployment

Modifications non cassants

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

New-CMApplication

Bogues corrigés

Correction 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 corrigés

Correction d’un problème pour le paramètre SanType.

New-CMCollection

Modifications non cassants

Correction de la validation avec le paramètre Name pour s’aligner sur la console.

New-CMOperatingSystemImage

Modifications non cassants

Ajout du paramètre Index. Lorsque vous ajoutez ce paramètre, le site extrait une image d’index unique à partir d’une image multi-index. Il place ensuite la nouvelle image dans le même dossier source que l’image d’origine.

New-CMOperatingSystemInstaller

Modifications non cassants

Ajout du paramètre Index. Lorsque vous ajoutez ce paramètre, le site remplace l’image multi-index actuelle par une nouvelle image d’index unique.

New-CMTSRule

Modifications non cassants

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

New-CMTSStepConditionVariable

Modifications non cassants

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

New-CMSoftwareUpdateAutoDeploymentRule

Changements cassants

Correction d’un problème pour le paramètre O365LanguageSelection. Vous devez maintenant spécifier une langue avec un nom de pays/région. Cette modification aligne ce paramètre avec les options de la console Configuration Manager. Par exemple, -O365LanguageSelection "English (États-Unis)"

Set-CMCertificateProfileScep

Bogues corrigés

Correction d’un problème pour le paramètre SanType.

Set-CMClientPushInstallation

Modifications non cassants

Ajoutez le paramètre AllownNTLMFallback pour activer le secours NTLM.

Set-CMCollection

Modifications non cassants

Correction de la validation avec le paramètre NewName pour l’aligner sur la console.

Set-CMEmailProfile

Modifications non cassants

  • Correction d’un 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

Modifications non cassants

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

Set-CMThirdPartyUpdateCatalog

Modifications non cassants

Ajoutez les paramètres CategoryNamePublishOption et CategoryIdPublishOption. Utilisez ces paramètres pour définir l’option de publication de catégorie lorsque 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

Modifications 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 applets de commande similaires.

Modifications non cassants

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

Set-CMSoftwareUpdateAutoDeploymentRule

Changements cassants

Correction 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 (États-Unis)"

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 Commentaires sur PowerShell.

  • Last updated on