Get-CMConfigurationPlatform

  • Référence
Module:
ConfigurationManager

Obtenez une plateforme de système d’exploitation pour une règle d’exigence.

Syntaxe

Get-CMConfigurationPlatform
   [-Fast]
   [-IsSupported <Boolean>]
   [[-Name] <String>]
   [-PlatformOption <PlatformType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMConfigurationPlatform
   [-Fast]
   [-Id] <Int32>
   [-IsSupported <Boolean>]
   [-PlatformOption <PlatformType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour obtenir une plateforme de système d’exploitation à utiliser avec une règle de configuration requise du système d’exploitation pour un type de déploiement d’application. Vous pouvez utiliser l’objet de sortie de cette applet de commande avec l’applet de commande New-CMRequirementRuleOperatingSystemValue .

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Ajouter une règle d’exigence pour un système d’exploitation par plateforme

Cet exemple utilise d’abord l’applet de commande Get-CMGlobalCondition pour obtenir la condition globale du système d’exploitation par défaut pour les appareils Windows non mobiles. Il définit ensuite des variables pour deux plateformes pour Windows Server 2016 et Windows Server 2019. Ensuite, il utilise l’applet de commande New-CMRequirementRuleOperatingSystemValue pour créer l’objet de règle d’exigence afin d’inclure ces deux plateformes. Enfin, il transmet cet objet de règle à l’applet de commande Set-CMScriptDeploymentType pour ajouter la condition requise.

$myGC = Get-CMGlobalCondition -Name "Operating System" | Where-Object PlatformType -eq 1

$platformA = Get-CMConfigurationPlatform -Name "All Windows Server 2019 and higher (64-bit)"

$platformB = Get-CMConfigurationPlatform -Name "All Windows Server 2016 and higher (64-bit)"

$myRule = $myGC | New-CMRequirementRuleOperatingSystemValue -RuleOperator OneOf -Platform $platformA, $platformB

Set-CMScriptDeploymentType -ApplicationName "Central App" -DeploymentTypeName "Install" -AddRequirement $myRule

Paramètres

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Fast

Ajoutez 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 un trafic réseau supplémentaire et diminuer les performances des applets de commande.

Si vous n’utilisez pas ce paramètre, l’applet de commande affiche un avertissement. Pour désactiver cet avertissement, définissez $CMPSSuppressFastNotUsedCheck = $true.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Id

Spécifiez la valeur entière pour le CI_ID de la plateforme. Par exemple, le CI_ID pour la plateforme Tous Windows Server 2019 et versions ultérieures (64 bits) est 287650.

Utilisez une commande similaire à la suivante pour découvrir les CI_ID d’une plateforme :

Get-CMConfigurationPlatform -Name "*Server 2019*" | Select-Object LocalizedDisplayName, CI_ID

Type:Int32
Alias:CI_ID
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-IsSupported

Configuration Manager définit toujours les plateformes héritées pour la compatibilité descendante. Définissez ce paramètre sur $true pour filtrer les résultats uniquement sur les plateformes actuellement prises en charge.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifiez le nom de la plateforme du système d’exploitation. Vous pouvez utiliser des caractères génériques :

  • *: plusieurs caractères
  • ?: caractère unique
Type:String
Alias:LocalizedDisplayName
Position:0
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PlatformOption

Utilisez ce paramètre pour filtrer les résultats par type de plateforme.

Type:PlatformType
Valeurs acceptées:None, Windows, Mobile, Mac, MixedPlatform
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

IResultObject[]

IResultObject

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_ConfigurationPlatform classe WMI du serveur.

Cette applet de commande est différente de l’applet de commande Get-CMSupportedPlatform similaire.