Share via


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 ad RenameWithUnc 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.

INPUTS

None

OUTPUTS

IResultObject#SMS_Program

MEGJEGYZÉSEK

Disable-CMProgram

Enable-CMProgram

Get-CMProgram

Remove-CMProgram

Set-CMProgram