Freigeben über

New-CMProgram

  • Referenz
Modul:
ConfigurationManager

Erstellen Sie ein neues Programm für ein Paket.

Syntax

New-CMProgram
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   -CommandLine <String>
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DriveLetter <String>]
   [-DriveMode <DriveModeType>]
   [-Duration <Int32>]
   -PackageName <String>
   [-ProgramRunType <ProgramRunType>]
   [-Reconnect <Boolean>]
   [-RunMode <RunModeType>]
   [-RunType <RunType>]
   -StandardProgramName <String>
   [-UserInteraction <Boolean>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMProgram
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   -CommandLine <String>
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DriveLetter <String>]
   [-DriveMode <DriveModeType>]
   [-Duration <Int32>]
   -PackageId <String>
   [-ProgramRunType <ProgramRunType>]
   [-Reconnect <Boolean>]
   [-RunMode <RunModeType>]
   [-RunType <RunType>]
   -StandardProgramName <String>
   [-UserInteraction <Boolean>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMProgram
   -CommandLine <String>
   [-CommandLineFolder <String>]
   [-Comment <String>]
   -DeviceProgramName <String>
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DownloadProgramType <DownloadProgramType>]
   -PackageName <String>
   [-Requirement <String>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMProgram
   -CommandLine <String>
   [-CommandLineFolder <String>]
   [-Comment <String>]
   -DeviceProgramName <String>
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DownloadProgramType <DownloadProgramType>]
   -PackageId <String>
   [-Requirement <String>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um ein Programm für ein Paket zu erstellen. Programme sind Befehle, die einem Configuration Manager-Paket zugeordnet sind. Sie identifizieren die Aktionen, die auftreten, wenn der Client das Clientpaket empfängt. Sie können demselben Paket mehrere Programme zuordnen. Weitere Informationen finden Sie unter Pakete und Programme in Configuration Manager.

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: Erstellen eines Programms

In diesem Beispiel werden die Cmdlet-Parameter zuerst in die Parametervariablesplatsiert. Es ist nicht erforderlich, die Parameter zu splatieren, es erleichtert nur das Lesen der Parameter für eine so lange Befehlszeile.

Mit diesem Befehl wird ein Programm mit dem Namen Scan x64 im Standardpaket für das Migrationstool für den Benutzerzustand für Windows erstellt.

$parameters = @{
  PackageName = "User State Migration Tool for Windows"
  StandardProgramName = "Scan x64"
  CommandLine = "amd64\scanstate.exe \\gold\sources$\userdata /i:miguser.xml /i:migapp.xml /o"
  RunType = "Normal"
  ProgramRunType = "OnlyWhenNoUserIsLoggedOn"
  DiskSpaceRequirement = 200
  DiskSpaceUnit = "MB"
  Duration = 100
  DriveMode = "RunWithUnc"
}
New-CMProgram @parameters

Parameter

-AddSupportedOperatingSystemPlatform

Geben Sie mindestens eine unterstützte Betriebssystemplattform an, die für das Programm hinzugefügt werden soll. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMSupportedPlatform .

Typ:IResultObject[]
Aliase:AddSupportedOperatingSystemPlatforms
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CommandLine

Geben Sie die Befehlszeile für das Programm an.

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

-CommandLineFolder

Geben Sie den Ordner an, der das ausführbare Programm enthält. Dieser Ordner kann ein absoluter Pfad auf dem Client oder ein Pfad relativ zum Verteilungsordner sein, der das Paket enthält.

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

-Comment

Geben Sie optionalen Text zum Programm an, z. B. eine Beschreibung. Auf Clientcomputern wird dieser Text zusammen mit dem Programm im Softwarecenter angezeigt.

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

-Confirm

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

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeviceProgramName

Gibt einen Geräteprogrammnamen an.

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

-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

-DiskSpaceRequirement

Geben Sie die Menge an Speicherplatz an, die das Softwareprogramm benötigt, um auf dem Computer ausgeführt zu werden. Der Wert muss größer oder gleich 0 sein. Wenn Sie einen Wert angeben, verwenden Sie den DiskSpaceUnit-Parameter , um Einheiten für den Wert anzugeben.

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

-DiskSpaceUnit

Geben Sie eine akzeptierte Einheit für den DiskSpaceRequirement-Parameter an .

Typ:DiskSpaceUnitType
Zulässige Werte:KB, MB, GB
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DownloadProgramType

Geben Sie an, wann das Programm ausgeführt werden soll.

Typ:DownloadProgramType
Zulässige Werte:AsSoonAsPossible, OnlyOverFastNetwork, OnlyWhenTheDeviceIsDocked
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DriveLetter

Wenn Sie den DriveMode-Parameter verwenden, geben Sie einen Laufwerkbuchstaben für den Speicherort an.

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

-DriveMode

Gibt an, ob das Programm einen bestimmten Laufwerkbuchstaben erfordert, der im DriveLetter-Parameter angegeben ist.

  • RunWithUnc: Führen Sie das Programm über den UNC-Pfad aus. Dieser Wert ist die Standardeinstellung. Ab Version 2010 wurde dieser Wert von RenameWithUncumbenannt.

  • RequiresDriveLetter: Das Programm verwendet einen beliebigen verfügbaren Laufwerkbuchstaben.

  • RequiresSpecificDriveLetter: Das Programm wird nur ausgeführt, wenn das Laufwerk noch nicht verwendet wird.

Typ:DriveModeType
Zulässige Werte:RunWithUnc, RequiresDriveLetter, RequiresSpecificDriveLetter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Duration

Gibt die maximale Zeitdauer an, die sie für die Ausführung des Programms erwarten. Der Standardwert beträgt 120 Minuten.

Typ:Int32
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

-PackageId

Geben Sie die ID des Pakets für dieses Programm an.

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

-PackageName

Geben Sie einen Paketnamen für dieses Programm an.

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

-ProgramRunType

Gibt die Anmeldebedingungen an, die für die Ausführung des Programms erforderlich sind.

Die Standardeinstellung ist OnlyWhenUserIsLoggedOn.

Typ:ProgramRunType
Zulässige Werte:OnlyWhenUserIsLoggedOn, WhetherOrNotUserIsLoggedOn, OnlyWhenNoUserIsLoggedOn
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Reconnect

Gibt an, ob der Clientcomputer erneut eine Verbindung mit dem Verteilungspunkt herstellen kann, wenn sich der Benutzer bei Windows anmeldet.

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

-Requirement

Gibt zusätzliche Anforderungen für Standard- oder Geräteprogramme an.

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

-RunMode

Geben Sie die Anmeldeinformationen an, die das Programm für die Ausführung auf dem Clientcomputer benötigt.

Typ:RunModeType
Zulässige Werte:RunWithUserRights, RunWithAdministrativeRights
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunType

Geben Sie den Modus an, in dem das Programm auf dem Clientcomputer ausgeführt wird.

Der Standardwert ist Normal.

Typ:RunType
Zulässige Werte:Normal, Minimized, Maximized, Hidden
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-StandardProgramName

Geben Sie den Standardprogrammnamen an.

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

-UserInteraction

Gibt an, ob Benutzern die Interaktion mit dem Programm gestattet werden soll.

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

-WhatIf

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

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WorkingDirectory

Geben Sie ein Arbeitsverzeichnis für das Programm an.

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

Eingaben

None

Ausgaben

IResultObject

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_Program WMI-Serverklasse.