New-CMProgram
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-Websitelaufwerk aus, z. PS XYZ:\>
B. . 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 .
Type: | IResultObject[] |
Aliases: | AddSupportedOperatingSystemPlatforms |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CommandLine
Geben Sie die Befehlszeile für das Programm an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeviceProgramName
Gibt einen Geräteprogrammnamen an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Aliases: | DiskSpaceReq |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DiskSpaceUnit
Geben Sie eine akzeptierte Einheit für den DiskSpaceRequirement-Parameter an .
Type: | DiskSpaceUnitType |
Accepted values: | KB, MB, GB |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DownloadProgramType
Geben Sie an, wann das Programm ausgeführt werden soll.
Type: | DownloadProgramType |
Accepted values: | AsSoonAsPossible, OnlyOverFastNetwork, OnlyWhenTheDeviceIsDocked |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DriveLetter
Wenn Sie den DriveMode-Parameter verwenden, geben Sie einen Laufwerkbuchstaben für den Speicherort an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 vonRenameWithUnc
umbenannt.RequiresDriveLetter
: Das Programm verwendet einen beliebigen verfügbaren Laufwerkbuchstaben.RequiresSpecificDriveLetter
: Das Programm wird nur ausgeführt, wenn das Laufwerk noch nicht verwendet wird.
Type: | DriveModeType |
Accepted values: | RunWithUnc, RequiresDriveLetter, RequiresSpecificDriveLetter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Duration
Gibt die maximale Zeitdauer an, die sie für die Ausführung des Programms erwarten. Der Standardwert beträgt 120 Minuten.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PackageId
Geben Sie die ID des Pakets für dieses Programm an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PackageName
Geben Sie einen Paketnamen für dieses Programm an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProgramRunType
Gibt die Anmeldebedingungen an, die für die Ausführung des Programms erforderlich sind.
Die Standardeinstellung ist OnlyWhenUserIsLoggedOn
.
Type: | ProgramRunType |
Accepted values: | OnlyWhenUserIsLoggedOn, WhetherOrNotUserIsLoggedOn, OnlyWhenNoUserIsLoggedOn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Reconnect
Gibt an, ob der Clientcomputer erneut eine Verbindung mit dem Verteilungspunkt herstellen kann, wenn sich der Benutzer bei Windows anmeldet.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Requirement
Gibt zusätzliche Anforderungen für Standard- oder Geräteprogramme an.
Type: | String |
Aliases: | Requirements |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunMode
Geben Sie die Anmeldeinformationen an, die das Programm für die Ausführung auf dem Clientcomputer benötigt.
Type: | RunModeType |
Accepted values: | RunWithUserRights, RunWithAdministrativeRights |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunType
Geben Sie den Modus an, in dem das Programm auf dem Clientcomputer ausgeführt wird.
Der Standardwert ist Normal
.
Type: | RunType |
Accepted values: | Normal, Minimized, Maximized, Hidden |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StandardProgramName
Geben Sie den Standardprogrammnamen an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserInteraction
Gibt an, ob Benutzern die Interaktion mit dem Programm gestattet werden soll.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
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: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WorkingDirectory
Geben Sie ein Arbeitsverzeichnis für das Programm an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
None
Ausgaben
IResultObject
Hinweise
Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_Program WMI-Serverklasse.
Ähnliche Themen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für