New-CMScript

Créez un script PowerShell dans Configuration Manager.

Syntax

New-CMScript
   [-Fast]
   -ScriptFile <String>
   -ScriptName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMScript
   [-Fast]
   -ScriptName <String>
   -ScriptText <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette cmdlet pour créer un script PowerShell. Ces scripts sont intégrés et gérés dans Configuration Manager.

Pour plus d’informations, voir Créer et exécuter des scripts PowerShellà partir de la console Configuration Manager.

Notes

Exécutez les cmdlets Configuration Manager à partir du lecteur de site Configuration Manager, par PS XYZ:\> exemple. Pour plus d’informations, voir la mise en place.

Exemples

Exemple 1 : Créer un script avec du texte

Cet exemple crée un script nommé CMScript. Il spécifie le texte du script.

New-CMScript -ScriptName "CMScript" -ScriptText 'Write-Host "New Script"'

Exemple 2 : Créer un script à partir d’un fichier

Cet exemple crée un script nommé ImportScript. Il importe le script à partir d’un fichier existant sur un partage réseau.

New-CMScript -ScriptName "ImportScript" -ScriptFile "\\abc\importedscript.ps1" -Fast

Paramètres

- Confirmer

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

- WhatIf

Présente ce qui se produit si le cmdlet s’exécute. La cmdlet ne s’exécute pas.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 cmdlet.

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ScriptFile

Spécifiez le chemin d’accès à un fichier de script PowerShell ( .ps1 ). Le texte du fichier est utilisé pour le script dans Configuration Manager.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ScriptName

Spécifiez un nom pour le script à créer.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ScriptText

Spécifiez le texte du script à créer.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Entrées

Néant

Sorties

System.Object