New-CMProgram
SYNOPSIS
Maak een nieuw programma voor een pakket.
SYNTAX
NewStandardProgram (standaard)
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
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
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
De cmdlet New-CMProgram maakt een programma in Configuration Manager. Programma's zijn opdrachten die zijn gekoppeld aan een Configuration Manager pakket. Programma's identificeren de acties die optreden wanneer de client het clientpakket ontvangt. U kunt meerdere programma's aan hetzelfde pakket koppelen.
Notitie
Voer Configuration Manager cmdlets uit vanaf Configuration Manager-sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.
EXAMPLES
Voorbeeld 1: Een standaardprogramma maken
Met deze opdracht maakt u een standaardprogramma in Configuration Manager.
New-CMProgram -PackageName "test" -StandardProgramName SPM -CommandLine "RunMe" -WorkingDirectory "C:\temp" -RunType Hidden -ProgramRunType OnlyWhenNoUserIsLoggedOn -DiskSpaceRequirement 100 -DiskSpaceUnit GB -Duration 100 -DriveMode RunWithUnc
Voorbeeld 2: Een apparaatprogramma maken
Met deze opdracht maakt u een apparaatprogramma in Configuration Manager.
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
Geef een of meer ondersteunde besturingssysteemplatforms op die u voor het programma wilt toevoegen. Gebruik de cmdlet Get-CMSupportedPlatform om dit object op te halen.
Type: IResultObject[]
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases: AddSupportedOperatingSystemPlatforms
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CommandLine
Geef de opdrachtregel voor het programma op.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CommandLineFolder
Geef de map op die het uitvoerbare programma bevat. Deze map kan een absoluut pad op de client zijn of een pad ten opzichte van de distributiemap die het pakket bevat.
Type: String
Parameter Sets: NewDeviceProgram, NewDeviceProgramById
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Opmerking
Geef optionele tekst over het programma op, zoals een beschrijving. Op clientcomputers wordt deze tekst weergegeven met het programma in Software Center.
Type: String
Parameter Sets: NewDeviceProgram, NewDeviceProgramById
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DeviceProgramName
Hiermee geeft u de naam van een apparaatprogramma op.
Type: String
Parameter Sets: NewDeviceProgram, NewDeviceProgramById
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DiskSpaceRequirement
Geef de hoeveelheid schijfruimte op die het softwareprogramma nodig heeft om op de computer te worden uitgevoerd. De waarde moet groter zijn dan of gelijk zijn aan nul. Als u een waarde opgeeft, gebruikt u de parameter DiskSpaceUnit om eenheden voor de waarde op te geven.
Type: String
Parameter Sets: (All)
Aliases: DiskSpaceReq
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DiskSpaceUnit
Geef een geaccepteerde eenheid op voor de parameter DiskSpaceRequirement.
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
Geef op wanneer het programma moet worden uitgevoerd.
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
Als u de parameter DriveMode gebruikt, geeft u een stationletter op voor de locatie.
Type: String
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DriveMode
Geeft aan of het programma een specifieke station letter vereist, opgegeven in de DriveLetter parameter.
RunWithUnc: Voer het programma uit vanaf het UNC-pad. Dit is de standaardwaarde. Vanaf versie 2010 is de naam van deze waarde gewijzigd inRenameWithUnc.RequiresDriveLetter: het programma maakt gebruik van een beschikbare stationletter.RequiresSpecificDriveLetter: Het programma wordt alleen uitgevoerd als het station nog niet in gebruik is.
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
-Duur
Hiermee geeft u de maximale hoeveelheid tijd die u verwacht dat het programma wordt uitgevoerd. De standaardwaarde is 120 minuten.
Type: Int32
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PackageId
Geef de id van het pakket voor dit programma op.
Type: String
Parameter Sets: NewStandardProgramById, NewDeviceProgramById
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PackageName
Geef een pakketnaam op voor dit programma.
Type: String
Parameter Sets: NewStandardProgram, NewDeviceProgram
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ProgramRunType
Hiermee geeft u de aanmeldingsvoorwaarden op die nodig zijn om het programma uit te voeren.
De standaardinstelling is 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
-Opnieuw verbinding maken
Geeft aan of de clientcomputer opnieuw verbinding maakt met het distributiepunt wanneer de gebruiker zich bij het Windows.
Type: Boolean
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Vereiste
Hiermee geeft u aanvullende vereisten op voor standaard- of apparaatprogramma's.
Type: String
Parameter Sets: NewDeviceProgram, NewDeviceProgramById
Aliases: Requirements
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RunMode
Geef de referenties op die het programma nodig heeft om uit te voeren op de clientcomputer.
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
Geef de modus op waarin het programma wordt uitgevoerd op de clientcomputer.
De standaardwaarde is 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
Geef de naam van het standaardprogramma op.
Type: String
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UserInteraction
Geeft aan of gebruikers mogen communiceren met het programma.
Type: Boolean
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-WorkingDirectory
Geef een werkmap op voor het programma.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.