Partager via

Get-CMScript

  • Référence
Module:
ConfigurationManager

Obtenez un script PowerShell dans Configuration Manager.

Syntaxe

Get-CMScript
   [-Author <String>]
   [-Fast]
   [-ScriptName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMScript
   [-Author <String>]
   [-Fast]
   -ScriptGuid <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour obtenir un script PowerShell Configuration Manager. Ces scripts sont intégrés et gérés dans Configuration Manager. Pour plus d’informations, consultez Créer et exécuter des scripts PowerShell à partir de la console Configuration Manager.

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 : Obtenir tous les scripts non approuvés

Cette commande obtient tous les scripts dans Configuration Manager qui ne sont pas approuvés.

Get-CMScript -Fast | Where-Object { -not $_.ApprovalState }

Exemple 2 : Obtenir des scripts à l’aide du nom

Cette commande obtient tous les scripts dont le nom commence par la lettre D.

Get-CMScript -ScriptName "D*"

Exemple 3 : Obtenir des scripts d’un auteur spécifique

Cette commande obtient tous les scripts de l’auteur avec le nom d’utilisateur jqpublic. Étant donné qu’il utilise le caractère générique astérisque (*), le domaine spécifique n’a pas d’importance. Elle retourne ensuite une table qui répertorie le nom du script, l’état d’approbation et l’heure de la dernière mise à jour.

Get-CMScript -Fast -Author "*jqpublic" | Select-Object ScriptName, ApprovalState, LastUpdateTime

Paramètres

-Author

Spécifiez l’auteur du script à obtenir. Par exemple : contoso\jqpublic.

Vous pouvez utiliser des caractères génériques :

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

-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

-ScriptGuid

S’applique à la version 2010 et ultérieure. Spécifiez le GUID d’un script à obtenir.

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

-ScriptName

Spécifiez un nom de script à obtenir.

Vous pouvez utiliser des caractères génériques :

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

Entrées

None

Sorties

IResultObject[]

IResultObject

Notes

Cette applet de commande retourne un objet pour la classe WMI SMS_Scripts .