Windows PowerShell modifications apportées à la mise à jour cumulative 4 pour System Center 2012 R2 Configuration Manager

Résumé

Cet article décrit les modifications Windows PowerShell incluses dans la mise à jour cumulative 4 (CU4) pour les Configuration Manager Microsoft System Center 2012 R2. D’autres correctifs CU4 sont décrits dans l’article suivant de la Base de connaissances Microsoft :

3026739 Description de la mise à jour cumulative 4 pour System Center 2012 R2 Configuration Manager

Problèmes résolus

Add-CMDeploymentType
- Lorsqu’un type de déploiement est utilisé pour importer ses informations (telles qu’AppV), le paramètre DeploymentTypeName est ignoré.
- Le paramètre WindowsPhoneStoreInstaller crée des types de déploiement incorrects. Il s’agit d’une régression de la mise à jour cumulative 1.
- Les emplacements non valides peuvent être spécifiés de manière incorrecte pour les types de déploiement suivants :
  - Windows Phone Store
  - Google Play Store
  - Apple Store
- Vous pouvez configurer les éléments suivants en tant que DownloadContentAsStreaming :
  - Déploiement MSI
  - Windows valeurs OnSlowNetworkMode de type .appx
L’affinité utilisateur-appareil Add-CMDeviceAffinityToUserpour les utilisateurs non-primaires ne peut pas être définie sur les appareils. Par exemple, ces utilisateurs peuvent être des utilisateurs qui sont découverts via Active Directory.
Add-CMDistributionPointUne valeur CertificateExpirationTimeUtc expirée peut être spécifiée.
Les valeurs Add-CMFallbackStatusPointStateMessageNum ne sont pas validées par rapport à la plage acceptable (100 à 100 000).
Export-CMPackageDes erreurs incorrectes sont signalées lorsque ExportFilePath est dans un format inattendu.
Get-CMSoftwareUpdateLe paramètre id qui permet d’interroger les mises à jour logicielles par valeur d’ID est manquant.
Get-CMStatusFilterRuleAucun résultat n’est retourné si le paramètre Name n’est pas spécifié.
Get-CMUser
- Les types d’objets incohérents sont retournés (SMS_CombinedUserResources ou objet basé sur SMS_Collection), en fonction des paramètres d’entrée. Il s’agit d’une régression de la version release de System Center 2012 R2 Configuration Manager. Consultez Get-CMUser remarques dans la section « Changements cassants » pour plus d’informations sur la façon dont ce correctif peut vous affecter.
- Les objets non utilisateur sont mis en correspondance lorsque vous utilisez Name ou ResourceId.
- N’interrogez pas les valeurs « SMSID » et « Name » pour SMS_CombinedUserResource enregistrements. Il s’agit d’une régression de la mise à jour cumulative 2.
Import-CMCertificateImpossible de lire le certificat spécifié par le paramètre Path. Il s’agit d’une régression de la mise à jour cumulative 2.
New-CMActiveDirectoryForestImpossible de créer un objet de forêt Active Directory. Il s’agit d’une régression de la mise à jour cumulative 2.
New-CMBoundaryAucune validation du paramètre Value par rapport au type. Cela permet une configuration de limite non valide.
New-CMClientSettingDes erreurs incorrectes sont signalées lorsque vous créez un paramètre client avec un argument type « Default ».
New-CMCollectionVariableImpossible d’ajouter de nouvelles variables à une collection qui a des variables préexistantes. Il s’agit d’une régression de la mise à jour cumulative 2.
New-CMSecondarySiteExpired CertificateExpirationTimeUtc peut être spécifié.
Remove-CMDeviceCollectionAutorise la suppression de la collection non-device lorsque vous l’utilisez avec InputObject ou pipeline.
Remove-CMUserCollectionAutorise la suppression d’une collection non utilisateur lorsque vous l’utilisez avec InputObject ou pipeline.
Set-CMAssetIntelligenceSynchronizationPointImpossible d’effacer le certificat proxy Asset Intelligence en définissant CertificateFile sur « $null ».
Set-CMBoundaryLe paramètre Value n’est pas validé pour une syntaxe correcte en fonction du type de limite ou du paramètre Type. Cela permet une configuration de limite non valide.
Set-CMClientPushInstallationLes exécutions successives d’applets de commande échouent après l’exécution de cette applet de commande.
Set-CMDeploymentType
- L’applet de commande échoue en mode silencieux si vous essayez de définir un type de déploiement qui n’existe pas dans une application.
- Permet de configurer un déploiement MSI ou Windows type .appx OnSlowNetworkMode en tant que DownloadContentAsStreaming.
- L’applet de commande échoue en mode silencieux si vous essayez de modifier un programme d’installation de type déploiement qui n’est pas reconnu par l’applet de commande.
Set-CMDeviceCollectionautorise la configuration de la collection hors appareil lorsque vous l’utilisez avec InputObject ou pipeline.
Set-CMDistributionPoint
- CertificateExpirationTimeUtc expiré peut être spécifié.
- La valeur AllowFallbackForContent ne s’applique pas au point de distribution.
Set-CMFileReplicationRouteFileReplicationAccountName ne valide pas correctement le nom d’utilisateur dans certaines circonstances.
La valeur Set-CMStateMigrationPointAllowFallbackForContent ne s’applique pas au point de migration d’état.
Set-CMSystemHealthValidatorPointComponentImpossible d’effacer les comptes de publication ou de requête Active Directory en définissant la valeur null ou vide pour PublishAccount et QueryAccount.
Set-CMUserCollectionautorise la configuration d’une collection non utilisateur lorsque vous l’utilisez avec InputObject ou pipeline.
Start-CMDistributionPointUpgradeExpired CertificateExpirationTimeUtc peut être spécifié.
Update-CMCertificateImpossible de lire le certificat spécifié par le paramètre Path. Il s’agit d’une régression de la mise à jour cumulative 2.

Modifications supplémentaires

Nouvelles applets de commande

Add-CMDeploymentTypeDependencyAjoute un type de déploiement en tant que dépendance à un groupe de dépendances. L’entrée requise est un objet de type de déploiement de Get-CMDeploymentType et un groupe de dépendances de [Get| New]-CMDeploymentTypeDependencyGroup.Exemple

Get-CMDeploymentType -ApplicationName MyApp | New-CMDeploymentTypeDependencyGroup -GroupName MyGroup | Add-CMDeploymentTypeDependency -DeploymentTypeDependency '(Get-CMDeploymentType -ApplicationName MyChildApp) '-IsAutoInstall $true
Add-CMDeploymentTypeSupersedenceDéfinit un type de déploiement pour remplacer un autre. L’entrée requise est un type de remplacement de Get-CMDeploymentType et de type de déploiement remplacé à partir de Get-CMDeploymentType.Exemple

Get-CMDeploymentType -ApplicationName MyApp | Add-CMDeploymentTypeSupersedence -SupersedingDeploymentType '(Get-CMDeploymentType -ApplicationName MySupersedingApp)
ConvertFrom-CMApplicationConvertit un objet « Application » du Kit de développement logiciel (SDK) AppMgmt en objet SMS_Application à insérer dans le fournisseur de SMS. Notez que cela crée uniquement une instance de SMS_Application. Il revient au code appelant de l’insérer dans WMI.Exemple
$app = Get-CMApplication -Name MyApp | ConvertTo-CMApplication # (placeholder code to make changes against $app object) $obj = ConvertFrom-CMApplication -Application $app $obj.Put()
ConvertFrom-CMConfigurationItemConvertit un objet configurationItem de modèle objet DCM ou un objet dérivé en chaîne XML.Exemple
$rule = Get-CMConfigurationItem | ConvertTo-CMConfigurationItem $xml = ConvertFrom-CMConfigurationItem -ConfigurationItem $rule
ConvertTo-CMApplicationConvertit un SMS_Application ou SMS_DeploymentType en objet « Application » du Kit de développement logiciel (SDK) AppMgmt. Peut être reconverti en « SMS_Application » à l’aide de l’applet de commande ConvertFrom-CMApplication.Exemple
$app = Get-CMApplication -Name MyApp | ConvertTo-CMApplication
ConvertTo-CMConfigurationItemConvertit un objet CI de la chaîne SMS Provider ou XML en objet SDK de modèle objet DCM dérivé de ConfigurationItem.Exemple

Get-CMConfigurationItem | ConvertTo-CMConfigurationItem
Get-CMCertificateObtenir les certificats stockés pour le site. Il peut s’agir de certificats de proxy isv, de média de démarrage ou de point de distribution. La sortie de cette applet de commande peut être pipelineée dans d’autres applets de commande certificate telles que Block-CMCertificate. Notez que les requêtes effectuées à l’aide de l’empreinte numérique peuvent être plus lentes que d’autres requêtes, en particulier avec des jeux de résultats volumineux.Exemple
$bootmedia = Get-CMCertificate -CertificateType BootMedia
Get-CMDeploymentTypeDependencyObtient les types de déploiement dépendants existants à partir d’un groupe de dépendances. L’entrée requise est un objet de groupe de dépendances de Get-CMDeploymentTypeDependencyGroup.Exemple

Get-CMDeploymentType -ApplicationName MyApp | Get-CMDeploymentTypeDependencyGroup -GroupName MyGroup | Get-CMDeploymentTypeDependency
Get-CMDeploymentTypeDependencyGroupObtient un groupe de dépendances de type de déploiement existant. Peut être modifié à l’aide de Add-CMDeploymentTypeDependency ou Remove-CMDeploymentTypeDependency. L’entrée requise est un objet de type de déploiement de Get-CMDeploymentType.Exemple

Get-CMDeploymentType -ApplicationName MyApp | Get-CMDeploymentTypeDependencyGroup
Get-CMDeploymentTypeSupersedenceObtient les remplacements pour un type de déploiement remplacé. L’entrée requise est un type de déploiement remplacé.Exemple

Get-CMDeploymentType -ApplicationName MyApp | Get-CMDeploymentTypeSupersedence
Get-CMMigrationSourceObtient des informations pour une hiérarchie source migrée. Peut être utilisé avec Sync-CMMigrationSource pour afficher l’état de la migration.Exemple

Get-CMMigrationSource | sélectionner État
Get-CMObjectSecurityScopeObtient toutes les étendues de sécurité associées au InputObject spécifié. Cela peut être utilisé sur n’importe quel objet qui utilise des étendues de sécurité.Exemple

Get-CMSoftwareUpdateGroup | Get-CMObjectSecurityScopeGet-CMBoundaryGroup | Get-CMObjectSecurityScope
Get-CMQueryObtient une requête.Exemple

Get-CMQuery - Nommez « Tous les appareils personnels »
Get-CMSiteDefinitionObtient les informations de définition de site à partir de SMS_SiteDefinition classe. Cela contient différents paramètres de configuration et à l’échelle du site.Exemple

Get-CMSiteDefinition -SiteCode PRI
Get-CMSiteRoleObtient une liste des rôles de site à partir d’un serveur de site ou de serveurs de site.Exemple

Get-CMSiteRole -SiteSystemServerName myserver.contoso.com
Get-CMSupportedPlatformsObtient une liste des plateformes prises en charge. Peut être utilisé pour la pipelining dans Import-CMDriver.Exemple

Get-CMSupportedPlatforms -Name 'All Windows*'
Invoke-CMQueryappelle une requête et retourne les résultats.Exemple

Get-CMQuery -Name « My Systems » | Invoke-CMQuery
Invoke-CMSystemDiscoverydemande au site de démarrer la découverte du système Active Directory dès que possible.Exemple

Invoke-CMSystemDiscovery -SiteCode ABC
Invoke-CMUserDiscoverydemande au site de démarrer la découverte d’utilisateurs Active Directory dès que possible.Exemple

Invoke-CMUserDiscovery -SiteCode ABC
Invoke-GroupDiscoverydemande au site de démarrer la découverte de groupe Active Directory dès que possible.Exemple

Invoke-CMGroupDiscovery -SiteCode ABC
New-CMADGroupDiscoveryScopeCrée un objet qui peut être utilisé pour configurer une étendue de découverte de groupe Active Directory avec Set-CMDiscoveryMethod.Exemple

Set-CMDiscoveryMethod -ActiveDirectoryGroupDiscovery '-AddGroupDiscoveryScope (New-CMADGroupDiscoveryScope '-name MyScope -SiteCode R2s -LdapLocation '"LDAP://CN=ScopeLocation,DC=contoso,DC=com »-RecursiveSearch $true)
New-CMDeploymentTypeDependencyGroupcrée un groupe de dépendances de type de déploiement abstrait. Doit être ajouté à un type de déploiement existant à l’aide de Add-CMDeploymentTypeDependency. L’entrée requise est un objet de type de déploiement de Get-CMDeploymentType.Exemple

Get-CMDeploymentType -ApplicationName MyApp | New-CMDeploymentTypeDependencyGroup -GroupName MyGroup
New-CMEmbeddedObjectInstancePour les cas d’utilisation avancés dans lesquels vous devez manipuler directement les objets résultants à partir du fournisseur SMS ou des requêtes d’objet. Crée un objet incorporé d’une classe ad hoc. Notez que pour les types « SMS_EmbeddedProperty » ou « SMS_EmbeddedPropertyList », il existe New-CMEmbeddedProperty et New-CMEmbeddedPropertyList.Exemple

$prop = New-CMEmbeddedObjectInstance -ClassName « SMS_EmbeddedProperty »

New-CMEmbeddedPropertyPour les cas d’utilisation avancée dans lesquels vous devez manipuler directement les résultats à partir du fournisseur SMS ou des requêtes d’objet. Crée une instance SMS_EmbeddedProperty et peut également définir des valeurs.Exemple

$dp = Get-CMDistributionPoint -SiteSystemServerName mydp001.contoso.com
 $embeddedProperty = New-CMEmbeddedProperty -PropertyName "UpdateBranchCacheKey" -Value 1
 $props = $dp.EmbeddedProperties
 $props["UpdateBranchCacheKey"] = $embeddedProperty
 $dp.EmbeddedProperties = $props
 $dp.Put()

New-CMEmbeddedPropertyListPour les cas d’utilisation avancés dans lesquels vous devez manipuler directement les objets de résultats à partir du fournisseur SMS ou des requêtes d’objet. Crée une instance SMS_EmbeddedPropertyList et peut également définir des valeurs.Exemple

$propList = New-CMEmbeddedPropertyList -PropertyListName MyList -Values (« abc », « def », « xyz »)
New-CMQuerycrée une requête.Exemple

New-CMQuery -Name « My Systems » -Expression '"select * from SMS_R_System where Name LIKE 'ABC%'
Remove-CMCollectionSupprime une collection indifférente par valeur, peut être utilisée au lieu de Remove-CMUserCollection et Remove-CMDeviceCollection pour la suppression de collection.Exemple

Get-CMUserCollection -Name MyCollection | Remove-CMCollection -ForceGet-CMDeviceCollection -Name MyDeviceCollection | Remove-CMCollection -Force
Remove-CMDeploymentTypeDependencySupprime une dépendance de type de déploiement d’un groupe de dépendances de type de déploiement. Si la suppression d’une dépendance entraîne l’absence de dépendances supplémentaires au groupe, celui-ci est supprimé. L’entrée requise est un objet de type de déploiement de Get-CMDeploymentType ou Get-CMDeploymentTypeDependency et un groupe de dépendances de Get-CMDeploymentTypeDependencyGroup.Exemple

$dpGroup = Get-CMDeploymentType -ApplicationName MyApp | Get-CMDeploymentTypeDependencyGroup -GroupName MyGroup '$dpDeps = Get-CMDeploymentTypeDependency -Group $dpGroupRemove-CMDeploymentTypeDependency -Group $dpGroup '-DeploymentTypeDependency $dpDeps[1] -Force
Remove-CMDeploymentTypeDependencyGroupsupprime un groupe de dépendances de type de déploiement (et ses dépendances) d’un type de déploiement. L’entrée requise est un groupe de dépendances de Get-CMDeploymentTypeDependencyGroup.Exemple

Get-CMDeploymentType -ApplicationName MyApp | Get-CMDeploymentTypeDependencyGroup -GroupName MyGroup | Remove-CMDeploymentTypeDependencyGroup -Force
Remove-CMDeploymentTypeSupersedenceSupprime un type de déploiement de remplacement d’un type de déploiement remplacé. L’entrée requise est un type de remplacement de Get-CMDeploymentType ou de Get-CMDeploymentTypeSupersedence et de type de déploiement remplacé à partir de Get-CMDeploymentType.Exemple

Get-CMDeploymentType -ApplicationName MyApp | Remove-CMDeploymentTypeSupersedence -SupersedingDeploymentType '(Get-CMDeploymentType -ApplicationName MySupersedingApp)
Remove-CMQuerySupprime une requête.Exemple

Get-CMQuery -Name « My Systems » | Remove-CMQuery -Force
Set-CMDeploymentTypeDependencyGroupconfigure les paramètres d’un groupe de types de déploiement. L’entrée requise est un groupe de dépendances de Get-CMDeploymentTypeDependencyGroup.Exemple

Get-CMDeploymentType -ApplicationName MyApp | Get-CMDeploymentTypeDependencyGroup -GroupName MyGroup | Set-CMDeploymentTypeDependencyGroup -NewName MyNewGroup
Set-CMDeploymentTypeSupersedenceConfigure les paramètres pour une remplacement de type de déploiement. L’entrée requise est un type de remplacement de Get-CMDeploymentType ou de Get-CMDeploymentTypeSupersedence et de type de déploiement remplacé à partir de Get-CMDeploymentType.Exemple

Get-CMDeploymentType -ApplicationName MyApp | Set-CMDeploymentTypeSupersedence -SupersedingDeploymentType '(Get-CMDeploymentType -ApplicationName MySupersedingApp) '-IsUninstall $true
Set-CMQueryConfigure une requête.Exemple

Get-CMQuery -Name « My Systems » | Set-CMQuery -NewName « My ABC Systems »
Sync-CMMigrationSourcedémarre une synchronisation pour une hiérarchie source migrée.Exemple

Sync-CMMigrationSource

Modifications non déchirantes

Ces modifications représentent des améliorations apportées aux applets de commande existantes. Il s’agit de modifications additives qui ne doivent pas entraîner de problèmes de compatibilité pour l’automatisation existante.

Add-CMDeploymentType
- Nouveau paramètre facultatif pour les règles d’exigences : AddRequirement. Les règles doivent être créées à l’aide du Kit de développement logiciel (SDK) du modèle objet DCM.
- Nouveau paramètre facultatif : Application. Accepte l’entrée de Get-CMApplication comme alternative pour ApplicationName.
Ajout du paramètre Add-CMDistributionPointNew EnableBranchCache pour activer le cache de branche pour le nouveau point de distribution.
Les paramètres Add-CMFallbackStatusPointThrottleInterval et StateMessageNum ne sont plus obligatoires. Les valeurs par défaut sont utilisées pour ThrottleInterval (3 600) et StateMessageNum (10 000) si aucune valeur n’est définie.
Block-CMCertificateNew Certificate parameter to allow for pipelining object from Get-CMCertificate.
Clear-CMClientOperationNouveau paramètre d’opération facultatif qui accepte l’entrée de Get-CMClientOperation.
Disable-CMStatusFilterRuleLe paramètre Name accepte désormais les valeurs génériques.
Enable-CMStatusFilterRuleLe paramètre Name accepte désormais les valeurs génériques.
Export-CMSecurityRolePrise en charge supplémentaire pour l’exportation des rôles de sécurité par nom (RoleName) ou par valeur (rôle).
Get-CMAppV5XDeploymentTypeItemaccepte désormais l’entrée pipelineée à partir de Get-CMDeploymentType.Exemple

Get-CMDeploymentType -ApplicationName « MyApp » '-DeploymentTypeName « AppV5X » | Get-CMAppV5XDeploymentTypeItem
Get-CMClientPushInstallationne nécessite plus de paramètre de recherche obligatoire pour rechercher les détails de l’installation push du client.
Get-CMDeploymentTypePeut créer un objet de résultat de pipeline à partir de Get-CMApplication pour obtenir les types de déploiement.Exemple

Get-CMApplication -Name « Contoso App » | Get-CMDeploymentType s-Name « MSI Installer »
Get-CMManagementPointComponentn’exige plus les paramètres SiteCode et SiteSystemName obligatoires.
Get-CMSoftwareUpdateNew optional OnlyExpired parameter to scope query to get only expired updates for faster requêtes.
Get-CMStatusFilterRuleLe paramètre Name accepte désormais les valeurs génériques.
Améliorations des performances get-CMUseravec des jeux de résultats volumineux.
Import-CMComputerInformationSmBiosId et MacAddress peuvent être définis lorsque vous utilisez ComputerName au lieu que les deux soient obligatoires. Si aucune des deux n’est définie, l’applet de commande échoue.
Import-CMDriver
- Nouveau paramètre ImportFolder facultatif pour indiquer que tous les pilotes du dossier spécifié à l’aide d’UncFileLocation doivent être traités.
- Nouveau paramètre supportedPlatforms facultatif qui accepte l’entrée de Get-CMSupportedPlatforms pour définir les plateformes prises en charge d’un pilote.
Lock-CMObjectAccepte désormais les objets via le pipeline.Exemple

Get-CMDriverPackage | Lock-CMObject
New-CMApplicationLe paramètre facultatif DisplaySupersedencesInApplicationCatalog permet d’afficher les remplacements dans le catalogue d’applications.
Nouveau-CMMaintenanceWindowLe nouveau paramètre de collection facultatif accepte l’entrée de Get-CMCollection.
Paramètre New-CMSecondarySiteNew EnableBranchCache ajouté pour activer le cache de branche pour le point de distribution de site secondaire.
Remove-CMApplicationRevisionHistoryaccepte l’entrée pipelineée de Get-CMApplicationRevisionHistory pour la suppression d’une révision d’application spécifique.Exemple

Get-CMApplicationRevisionHistory -Name « Contoso App » -Revision 2 | Remove-CMApplicationRevisionHistory
Remove-CMClientOperationLe nouveau paramètre d’opération facultatif accepte l’entrée de Get-CMClientOperation.
Remove-CMDeploymentLe nouveau paramètre de déploiement facultatif accepte un objet de Get-CMDeployment qui permet de supprimer les déploiements de mise à jour, de package, de système d’exploitation et d’application.Notez que DeploymentId et ApplicationName continueront à prendre en charge uniquement les déploiements d’applications. Ce comportement est susceptible de changer dans une version ultérieure.
Remove-CMDeploymentTypeLe paramètre ApplicationName n’est plus requis lorsque vous utilisez DeploymentType ou pipeline à partir de Get-CMDeploymentType.
Remove-CMMaintenanceWindowLe nouveau paramètre de collection facultatif accepte les entrées de Get-CMCollection.
Remove-CMStatusFilterRuleLe paramètre Name accepte désormais les valeurs génériques.
Set-ClientPushInstallationPrend désormais en charge la mise en pipeline à partir de Get-CMClientPushInstallation.
Set-CMApplicationLe nouveau paramètre facultatif DisplaySupersedencesInApplicationCatalog permet d’afficher les remplacements dans le catalogue d’applications.
Set-CMDeploymentType
- Nouveaux paramètres facultatifs pour les règles de configuration requise :
  - AddRequirement
  - RemoveRequirement
  - ClearRequirements
  Les règles doivent être créées à l’aide du Kit de développement logiciel (SDK) du modèle objet DCM. L’entrée NoteRemoveRequirement doit correspondre à la valeur RuleId de la règle d’exigence dans le type de déploiement. Sinon, elle ne sera pas supprimée.
- ApplicationName n’est plus un paramètre obligatoire si un objet d’entrée DeploymentType est utilisé.
- Prend désormais en charge la pipelining à partir de Get-CMDeploymentType.
Exemple

Get-CMDeploymentType -ApplicationName sccmapp '-DeploymentTypeName adberdr934_4.6.33.315 | Set-CMDeploymentType -AppV5xInstaller -OnSlowNetworkMode DoNothing
Set-CMDiscoveryMethod
- Nouveaux paramètres facultatifs lorsque vous configurez la découverte de groupe avec ActiveDirectoryGroupDiscovery :
  - AddGroupDiscoveryScope
  - RemoveGroupDiscoveryScope
- AddGroupDiscoveryScope nécessite une entrée créée par l’applet de commande New-CMADGroupDiscoveryScope.
- RemoveGroupDiscoveryScope nécessite un nom d’étendue correspondant à une chaîne.
Exemple

Set-CMDiscoveryMethod -ActiveDirectoryGroupDiscovery '-AddGroupDiscoveryScope (New-CMADGroupDiscoveryScope '-name MyScope -SiteCode R2S -LdapLocation '"LDAP://CN=ScopeLocation,DC=contoso,DC=com » -RecursiveSearch $true)
Paramètre Set-CMDistributionPointNew EnableBranchCache ajouté pour configurer le cache de branche sur le point de distribution.
Set-CMMaintenanceWindowLe nouveau paramètre de collection facultatif accepte l’entrée de Get-CMCollection.
Set-CMManagementPointComponentAccepte désormais l’entrée pipelineée à partir des applets de commande suivantes :
- Get-CMSiteDefinition (nouvelle applet de commande)
- Get-CMManagementPoint
- Get-CMSite
- Get-CMManagementPointComponent
Set-CMPackage
- Nouveaux paramètres facultatifs pour modifier les propriétés de distribution (préconfiguration, multidiffusion) et de source de données (mise à jour du package) pour correspondre aux feuilles de propriétés de la console d’administration.
- Renommage de plusieurs paramètres par souci de clarté et de cohérence. Ces paramètres nouvellement nommés sont alias des anciens noms pour préserver la compatibilité.
Le paramètre Unblock-CMCertificateNew Certificate permet de diriger l’objet à partir de Get-CMCertificate.
Unlock-CMObjectNow accepte les objets via le pipeline.Exemple

Get-CMDriverPackage | Unlock-CMObject
Update-CMCertificate
- Le nouveau paramètre Force facultatif empêche l’invite de remplacer le certificat existant.
- Le nouveau paramètre Certificate permet de diriger l’objet à partir de Get-CMCertificate.

Informations importantes pour toutes les applets de commande

Les nouveaux paramètres facultatifs DisableWildcardHandling et ForceWildcardHandling-DisableWildcardHandling autorisent les applets de commande et les paramètres qui prennent en charge les caractères génériques (« * » ou « ? »). valeurs pour analyser de force le paramètre en tant que valeur littérale au lieu d’une valeur générique.Considérez le scénario suivant : vous avez deux applications : « Mon application informatique » et « Mon*application ». L’applet de commande Get-CMApplication -Name My*Application retourne à la fois « Mon application informatique » et « Mon*application ». Si l’objectif est de récupérer uniquement « My*Application », vous pouvez ajouter DisableWildcardHandling aux paramètres de l’applet de commande pour récupérer une correspondance.

Le paramètre ForceWildcardHandling restaure le comportement pré-R2 CU1 et permet de reconnaître de nombreux arguments de paramètre d’applet de commande basés sur des chaînes en tant que valeurs génériques au lieu de valeurs littérales. Ce paramètre peut entraîner le comportement des applets de commande de manière inattendue ou non prise en charge et doit être utilisé avec beaucoup de soin.
Un message d’avertissement est écrit dans le flux de sortie PowerShell lorsque le comportement de requête interne est modifié par ces paramètres.
Notez que, bien que toutes les applets de commande Configuration Manager prennent en charge ces nouveaux paramètres, les paramètres peuvent ne pas être utilisés ou respectés en toutes circonstances.
Les paramètres DisableWildcardHandling et ForceWildcardHandling ne peuvent pas être utilisés en même temps. Si vous utilisez les deux paramètres en même temps, l’exécution de l’applet de commande échoue.

Autres changements non déchirants significatifs

Journalisation améliorée lorsque Verbose est activé autour de la création, de la modification, de la suppression et de l’enregistrement d’objets fournisseur SMS.
Amélioration de l’efficacité des requêtes de compte d’utilisateur de système de site.
L’utilisation d’une applet de commande ou d’un paramètre déprécié peut entraîner l’écriture d’un avertissement dans la console Windows PowerShell. Les applets de commande ou paramètres dépréciés peuvent être supprimés dans une version ultérieure, et leur utilisation doit être abandonnée dès que possible.

Applets de commande et paramètres dépréciés (peuvent être supprimés à l’avenir)

L’utilisation de ces paramètres dépréciés doit être abandonnée dès que possible afin d’éviter d’éventuelles modifications cassantes dans une version ultérieure.Notez que l’utilisation d’une applet de commande ou d’un paramètre déprécié peut entraîner l’écriture d’un avertissement dans la console Windows PowerShell.

Add-CMDeploymentType
- Le paramètre ForceForUnknownPublisher n’est plus utilisé lorsque vous créez les types de déploiement suivants :
  - Apple Store
  - Windows Phone 8
  - Google Play
- Le paramètre AutoIdentifyFromInstallationFile n’est plus utilisé lorsque vous créez les types de déploiement suivants :
  - Application Virtualization 5
  - Application web
  - Apple Store
  - Windows Phone 8
  - Google Play
- Le paramètre AutoIdentifyFromInstallationFile n’est plus nécessaire pour plusieurs types de déploiement.
- Le paramètre ForceForUnknownPublisher n’est plus requis.
- Le paramètre ManualSpecifyDeploymentType n’est plus obligatoire et n’affecte pas la création du type de déploiement.
Get-CMClientOperations Remplacé par Get-CMClientOperation (nom unique ou pluriel) pour assurer la cohérence avec d’autres appletsde commande Verb-CMClientOperation. Les fonctionnalités ne changent pas.
Get-CMManagementPointComponentRemplacé par l’applet de commande Get-CMSiteDefinition. Cette applet de commande est fonctionnellement identique à Get-CMManagementPoint et est déconseillée pour éliminer la confusion.
Import-CMDriverSupportedPlatformName est déconseillé. SupportedPlatforms doit être utilisé à la place. Les valeurs SupportedPlatforms peuvent être récupérées à l’aide de l’applet de commande Get-CMSupportedPlatform. L’utilisation de SupportedPlatformName et de SupportedPlatforms n’est pas prise en charge.
Remove-CMDeploymentTypeLe paramètre ApplicationName n’est plus requis lorsque vous utilisez DeploymentType ou pipeline à partir de Get-CMDeploymentType.
Set-CMAssetIntelligenceSynchronizationPointLe paramètre EnableSynchronization est déconseillé. Définissez ScheduleToken sur $null pour désactiver la synchronisation planifiée.
Set-CMClientPushInstallationLe paramètre Name ne doit pas être utilisé. Le code de site doit être utilisé à la place pour étendre la sortie à un site spécifique.
La valeur Set-CMDeploymentTypeOnFastNetworkMode RunFromNetwork est remplacée par DownloadContentForStreaming.
Set-CMSystemHealthValidatorPointLes paramètres date et heure sont déconseillés au lieu du paramètre StatementOfHealthStartTime.
Start-CMPackageDeployment
- DeploymentStartDay et DeploymentStartTime sont remplacés par DeploymentStartDateTime à usage unique pour définir la date et l’heure.
- DeploymentAvailableDay et DeploymentAvailableTime sont remplacés par DeploymentAvailableDateTime à usage unique pour définir la date et l’heure.
- DeploymentExpireDay et DeploymentExpireTime sont remplacés par DeploymentExpireDateTime à usage unique pour définir la date et l’heure.

Important L’utilisation du paramètre SecuredScopeNames dans les applets de commande prises en charge doit être abandonnée et Get-CMObjectSecurityScope doit être utilisée à la place.

Changements cassants

Les changements cassants sont des modifications apportées au comportement des applets de commande ou des paramètres susceptibles de provoquer des incompatibilités avec PowerShell Automation existant. Vérifiez les modifications apportées ici par rapport à votre automatisation existante pour vous assurer de la compatibilité.

L’applet de commande Add-CMDeploymentTypene vous permet plus d’ajouter un type de déploiement qui a le même nom d’affichage qu’un type de déploiement précédemment ajouté. Les noms de types de déploiement doivent être uniques.
Bloquer-CMCertificateEn cas d’erreur lors du blocage du certificat, l’applet de commande échoue maintenant au lieu d’imprimer un message d’avertissement.
Get-CMSoftwareUpdateGroupLe paramètre SecuredScopeNames non fonctionnel est supprimé.
Get-CMUserdans la mise à jour cumulative 1, Get-CMUser a subi un changement de comportement inattendu dans lequel il retournerait des objets basés sur SMS_CombinedUserResource ou SMS_Collection. Le comportement de la version release de System Center 2012 R2 Configuration Manager était de retourner uniquement des objets basés sur SMS_Collection. Ceci est corrigé. Les mêmes données se trouve dans les deux classes, car SMS_CombinedUserResource contient un sous-ensemble des données SMS_Collection. Par conséquent, cela ne doit pas interrompre Automation. Toutefois, cette information est divulguée à des fins de sensibilisation.
Remove-CMSoftwareUpdateGroupLe paramètre SecuredScopeNames non fonctionnel est supprimé.
Remove-CMUserSi un utilisateur ne peut pas être supprimé pour une raison quelconque, l’applet de commande échoue. Dans les versions précédentes, certaines conditions provoquaient l’échec silencieux de l’applet de commande.
Set-CMBootImageLes paramètres non applicables suivants entraînent l’échec de l’applet de commande si vous les utilisez avec une image de démarrage Windows PE 3.1 ou antérieure :
- EnablePrestartCommand
- PrestartCommandLine
- IncludeFilesForPrestart
- PrestartIncludeFilesDirectory
- BackgroundBitmapPath
- ScratchSpace
- EnableCommandSupport
- PersistContentInCache
- EnableBinaryDeltaReplication
- DeployFromPxeDistributionPoint
- DistributionPointUpdateSchedule
- CustomPackageShareName
- DisconnectUsersFromDistributionPoints
- DisconnectUsersFromDistributionPointsRetries
- DisconnectUsersFromDistributionPointsMinutes
- AddOptionalComponents
- RemoveOptionalComponents
- CopyPackageToShareOnDistributionPoints
Set-CMBoundaryn’active plus plusieurs valeurs d’entrée pour l’ID ou le nom.Solution de contournementUtilisez des boucles ou un pipeline à partir de Get-CMBoundary.
Set-CMSoftwareUpdateGroupLe paramètre SecuredScopeNames non fonctionnel est supprimé.
L’applet de commande Set-CMSoftwareUpdatePointComponentéchoue si la définition de SynchronizeAction sur SynchronizeFromAnUpstreamDataSourceLocation sans spécifier de valeur pour UpstreamSourceLocation.
L’applet de commande Start-CMSoftwareUpdateDeploymentéchoue au lieu d’avertir si les mises à jour logicielles ne sont pas encore téléchargées.

Autres changements cassants significatifs

De nombreuses applets de commande avaient configuré incorrectement « ValueFromPipelineByPropertyName » pour les paramètres. Ceci est corrigé. Bien qu’il soit peu probable qu’une automatisation existante en tire profit, nous le constatons à des fins de sensibilisation.

Problèmes connus

Les problèmes connus suivants avec les applets de commande ne sont pas résolus dans cette version.

Set-CMAlertSubscriptionLe paramètre LocaleId nécessite que les paramètres régionaux spécifiques soient présents sur le système au lieu d’être des paramètres régionaux valides.
Set-CMDeploymentTypeNe peut pas configurer les paramètres de contenu pour les types de déploiement suivants :
- Windows Phone
- Apple App Store
- Google Play
L’applet de commande New-CMVhdretourne une erreur « Introuvable » lorsque vous essayez de localiser une référence de package de séquence de tâches. Il s’agit d’une régression de la mise à jour cumulative 2.
Get-CMAccessAccountUserName effectue une correspondance respectant la casse lors de l’interrogation du fournisseur SMS.
Set-CMSoftwareUpdatePointLes modifications apportées aux paramètres DefaultWsusServer ne s’appliquent pas à la configuration WSUS pour un point de mise à jour logicielle.
Set-CMBootImageLes valeurs EnablePrestartCommand et PrestartCommandLine ne sont pas appliquées à l’image de démarrage.
Le point de gestion Add-CMManagementPointcréé par l’applet de commande ne peut pas être affiché dans la console d’administration.Contournement

$mp = get-cmmanagementpoint -SiteSystemServerName yourmanagementpointfqdn$props = $mp. EmbeddedProperties$ep = $mp. ConnectionManager.CreateEmbeddedObjectInstance(« SMS_EmbeddedProperty »)$ep. PropertyName = « Type d’authentification"$props. Remove(« Type d’authentification »)$props. Add(« Type d’authentification », $ep)$mp. EmbeddedProperties = $props$mp. Put()
L’applet de commande Get-CMStatusReportingComponentpeut échouer si vous l’exécutez après avoir exécuté Set-CMStatusReportingComponent.
L’applet de commande Start-CMSoftwareUpdateDeploymentéchoue si la mise à jour nécessite l’acceptation des termes du contrat de licence logiciel Microsoft.
L’applet de commande New-CMVhdpeut échouer avec une erreur « Objet introuvable » lorsque vous créez un disque dur virtuel.
L’applet de commande Set-CMOutOfBandManagementComponentpeut échouer si le paramètre EnrollmentPoint est utilisé.
Les modifications add-CMStateMigrationPointAllowFallbackSourceLocationForContent peuvent ne pas s’appliquer au rôle de point de migration d’état.
La valeur Add-CMOutOfBandServicePointThreadsOffset peut ne pas s’appliquer au point de service hors bande nouvellement créé.Solution de contournementUtilisez Set-CMOutOfBandServicePoint -TransmissionStartMinutesInterval après avoir exécuté Add-CMOutOfBandServicePoint.

Références

Découvrez la terminologie utilisée par Microsoft pour décrire les mises à jour logicielles.