New-CMProgram
SYNOPSIS
Hozzon létre egy új programot egy csomaghoz.
SYNTAX
NewStandardProgram (alapértelmezett)
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>]
NewStandardProgramById (ÚjStandardProgramById)
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>]
NewDeviceProgram
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>]
NewDeviceProgramById (Új ProgramById)
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>]
DESCRIPTION
A New-CMProgram parancsmag egy programot hoz létre a Konfigurációkezelő. A programok olyan parancsok, amelyek egy Konfigurációkezelő vannak társítva. A programok azonosítják azokat a műveleteket, amelyek akkor következnek be, amikor az ügyfél megkapja az ügyfélcsomagot. Egy csomaghoz több programot is társíthat.
Megjegyzés
Futtassa Konfigurációkezelő parancsmagokat a Konfigurációkezelő hely meghajtóról, például: PS XYZ:\>
. További információ: Első lépések.
EXAMPLES
1. példa: Standard program létrehozása
Ez a parancs egy standard programot hoz létre a Konfigurációkezelő.
New-CMProgram -PackageName "test" -StandardProgramName SPM -CommandLine "RunMe" -WorkingDirectory "C:\temp" -RunType Hidden -ProgramRunType OnlyWhenNoUserIsLoggedOn -DiskSpaceRequirement 100 -DiskSpaceUnit GB -Duration 100 -DriveMode RunWithUnc
2. példa: Eszközprogram létrehozása
Ez a parancs eszközprogramot hoz létre a Konfigurációkezelő.
New-CMProgram -PackageName "Contoso-12" -DeviceProgramName DPM -Comment "Upgrades for December" -WorkingDirectory "C:\temp" -CommandLine "RunMe" -CommandLineFolder "C:\Windows\" -DiskSpaceRequirement 10 -DiskSpaceUnit GB -DownloadProgramType OnlyWhenTheDeviceIsDocked -Requirement "All previous updates"
PARAMETERS
-AddSupportedOperatingSystemPlatform
Adjon meg egy vagy több támogatott operációsrendszer-platformot, amelyet hozzá szeretne adni a programhoz. Ezt az objektumot a Get-CMSupportedPlatform parancsmag használatával lehet lekérte.
Type: IResultObject[]
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases: AddSupportedOperatingSystemPlatforms
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CommandLine (Parancssor)
Adja meg a program parancssorát.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CommandLineFolder
Adja meg a végrehajtható programot tartalmazó mappát. Ez a mappa lehet az ügyfél abszolút elérési útja, vagy a csomagot tartalmazó terjesztési mappához viszonyított relatív elérési út.
Type: String
Parameter Sets: NewDeviceProgram, NewDeviceProgramById
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Comment (Megjegyzés)
Adjon meg nem kötelező szöveget a programról, például egy leírást. Az ügyfélszámítógépeken ez a szöveg jelenik meg a szoftverrel együtt a Szoftverközpontban.
Type: String
Parameter Sets: NewDeviceProgram, NewDeviceProgramById
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DeviceProgramName
Megadja az eszközprogram nevét.
Type: String
Parameter Sets: NewDeviceProgram, NewDeviceProgramById
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Ez a paraméter literál karakterértékekként kezeli a helyettesítő karaktereket. Nem kombinálhatja a ForceWildcardHandling használatával.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DiskSpaceRequirement
Adja meg, hogy a szoftvernek mennyi lemezterületre van szüksége a számítógépen való futtatáshoz. Az értéknek nullánál nagyobbnak vagy egyenlőnek kell lennie. Ha megad egy értéket, a DiskSpaceUnit paraméterrel adhatja meg az érték mértékegységét.
Type: String
Parameter Sets: (All)
Aliases: DiskSpaceReq
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DiskSpaceUnit
Adjon meg egy elfogadott egységet a DiskSpaceRequirement paraméterhez.
Type: DiskSpaceUnitType
Parameter Sets: (All)
Aliases:
Accepted values: KB, MB, GB
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DownloadProgramType (Programtípus letöltése)
Adja meg, hogy mikor fusson a program.
Type: DownloadProgramType
Parameter Sets: NewDeviceProgram, NewDeviceProgramById
Aliases:
Accepted values: AsSoonAsPossible, OnlyOverFastNetwork, OnlyWhenTheDeviceIsDocked
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DriveLetter
Ha a DriveMode paramétert használja, adjon meg egy meghajtóbetűjelet a helyhez.
Type: String
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DriveMode (DriveMode)
Azt jelzi, hogy a programnak szüksége van-e egy adott, a DriveLetter paraméterben megadott meghajtóbetűjelre.
RunWithUnc
: Futtassa a programot az UNC elérési útról. Ez az alapértelmezett érték. A 2010-es verziótól kezdve ez az érték új nevet adRenameWithUnc
vissza.RequiresDriveLetter
: A program bármilyen elérhető meghajtóbetűjelet használ.RequiresSpecificDriveLetter
: A program csak akkor fut, ha a meghajtó még nincs használatban.
Type: DriveModeType
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:
Accepted values: RunWithUnc, RequiresDriveLetter, RequiresSpecificDriveLetter
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Duration (Időtartam)
Megadja a program futtatásának várt maximális idejét. Az alapértelmezett érték 120 perc.
Type: Int32
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Ez a paraméter feldolgozza a helyettesítő karaktereket, és váratlan viselkedéshez vezethet (nem ajánlott). Nem kombinálhatja a DisableWildcardHandling használatával.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PackageId (Csomagazonosító)
Adja meg a csomag azonosítóját a programhoz.
Type: String
Parameter Sets: NewStandardProgramById, NewDeviceProgramById
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PackageName (Csomagnév)
Adja meg a program csomagnevét.
Type: String
Parameter Sets: NewStandardProgram, NewDeviceProgram
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ProgramRunType
Megadja a program futtatásához szükséges bejelentkezési feltételeket.
Az alapértelmezett beállítás: OnlyWhenUserIsLoggedOn
.
Type: ProgramRunType
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:
Accepted values: OnlyWhenUserIsLoggedOn, WhetherOrNotUserIsLoggedOn, OnlyWhenNoUserIsLoggedOn
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Reconnect (Újracsatlakozás)
Azt jelzi, hogy az ügyfélszámítógép újra csatlakozik-e a terjesztési ponthoz, amikor a felhasználó bejelentkezik a Windows.
Type: Boolean
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Requirement (Követelmény)
A standard vagy eszközprogramokra vonatkozó további követelményeket határozza meg.
Type: String
Parameter Sets: NewDeviceProgram, NewDeviceProgramById
Aliases: Requirements
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RunMode (Futtatás mód)
Adja meg azokat a hitelesítő adatokat, amelyekre a programnak szüksége van az ügyfélszámítógépen való futtatáshoz.
Type: RunModeType
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:
Accepted values: RunWithUserRights, RunWithAdministrativeRights
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RunType (Futtatás típusa)
Adja meg azt a módot, amelyben a program fut az ügyfélszámítógépen.
Az alapértelmezett érték Normal
.
Type: RunType
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:
Accepted values: Normal, Minimized, Maximized, Hidden
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-StandardProgramName
Adja meg a program szabványos nevét.
Type: String
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UserInteraction
Azt jelzi, hogy engedélyezi-e a felhasználók számára a programon keresztüli interakciót.
Type: Boolean
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-WorkingDirectory (Munkakönyvtár)
Adjon meg egy munkakönyvtárat a program számára.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Ez a parancsmag a következő általános paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction és -WarningVariable. További információ: about_CommonParameters.