New-CMScript

Erstellen Sie ein PowerShell-Skript in 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>]

Beschreibung

Verwenden Sie dieses Cmdlet, um ein neues PowerShell-Skript zu erstellen. Diese Skripts sind in Configuration Manager integriert und verwaltet.

Weitere Informationen finden Sie unter Erstellen und Ausführen von PowerShell-Skripts in der Configuration Manager-Konsole.

Hinweis

Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".

Beispiele

Beispiel 1: Erstellen eines Skripts mit Text

In diesem Beispiel wird ein neues Skript namens CMScripterstellt. Es gibt den Text des Skripts an.

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

Beispiel 2: Erstellen eines Skripts aus einer Datei

In diesem Beispiel wird ein neues Skript namens ImportScripterstellt. Das Skript wird aus einer vorhandenen Datei in einer Netzwerkfreigabe importiert.

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

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

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

-Fast

Fügen Sie diesen Parameter hinzu, um nicht automatisch verzögerte Eigenschaften zu aktualisieren. Lazy-Eigenschaften enthalten Werte, die relativ ineffizient abzurufen sind. Das Abrufen dieser Eigenschaften kann zusätzlichen Netzwerkdatenverkehr verursachen und die Leistung von Cmdlets verringern.

Wenn Sie diesen Parameter nicht verwenden, zeigt das Cmdlet eine Warnung an. Um diese Warnung zu deaktivieren, legen Sie $CMPSSuppressFastNotUsedCheck = $true fest.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.

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

-ScriptFile

Geben Sie den Pfad zu einer PowerShell-Skriptdatei an ( .ps1 ). Der Text der Datei wird für das Skript in Configuration Manager verwendet.

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

-ScriptName

Geben Sie einen Namen für das zu erstellende Skript an.

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

-ScriptText

Geben Sie den Text des zu erstellenden Skripts an.

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

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

Keine

Ausgaben

System.Object