Freigeben über


Get-CMScript

Abrufen eines PowerShell-Skripts in Configuration Manager.

Syntax

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

Beschreibung

Verwenden Sie dieses Cmdlet, um ein Configuration Manager-PowerShell-Skript abzurufen. Diese Skripts werden in Configuration Manager integriert und verwaltet. Weitere Informationen finden Sie unter Erstellen und Ausführen von PowerShell-Skripts über die Configuration Manager-Konsole.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Abrufen aller nicht genehmigten Skripts

Dieser Befehl ruft alle Skripts in Configuration Manager ab, die nicht genehmigt wurden.

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

Beispiel 2: Abrufen von Skripts mithilfe des Namens

Dieser Befehl ruft alle Skripts ab, die einen Namen haben, der mit dem Buchstaben Dbeginnt.

Get-CMScript -ScriptName "D*"

Beispiel 3: Abrufen von Skripts von einem bestimmten Autor

Dieser Befehl ruft alle Skripts für den Autor mit dem Benutzernamen jqpublic ab. Da der Platzhalter das Sternchen (*) verwendet, spielt die jeweilige Domäne keine Rolle. Anschließend wird eine Tabelle zurückgegeben, die den Skriptnamen, den Genehmigungsstatus und den Zeitpunkt der letzten Aktualisierung auflistet.

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

Parameter

-Author

Geben Sie den Autor des abzurufenden Skripts an. Beispiel: contoso\jqpublic.

Sie können Ein-/Auslesezeichen verwenden:

  • *: Mehrere Zeichen
  • ?: Einzelnes Zeichen
Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Fast

Fügen Sie diesen Parameter hinzu, um verzögerte Eigenschaften nicht automatisch zu aktualisieren. Verzögerte Eigenschaften enthalten Werte, die relativ ineffizient abgerufen werden können. Das Abrufen dieser Eigenschaften kann zusätzlichen Netzwerkdatenverkehr verursachen und die Cmdlet-Leistung beeinträchtigen.

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ScriptGuid

Gilt für Version 2010 und höher. Geben Sie die GUID eines abzurufenden Skripts an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ScriptName

Geben Sie einen Skriptnamen an, der abgerufen werden soll.

Sie können Ein-/Auslesezeichen verwenden:

  • *: Mehrere Zeichen
  • ?: Einzelnes Zeichen
Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

Eingaben

None

Ausgaben

IResultObject[]

IResultObject

Hinweise

Dieses Cmdlet gibt ein Objekt für die SMS_Scripts WMI-Klasse zurück.