New-CMProgram
SYNOPSIS
Skapa ett nytt program för ett paket.
SYNTAX
NewStandardProgram (standard)
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
Cmdleten New-CMProgram skapar ett program i Konfigurationshanteraren. Program är kommandon som är associerade med ett Konfigurationshanteraren paket. Program identifierar de åtgärder som inträffar när klienten tar emot klientpaketet. Du kan associera flera program med samma paket.
Anteckning
Kör Konfigurationshanteraren cmdlets från Konfigurationshanteraren platsenheten, till exempel PS XYZ:\> . Mer information finns i Komma igång.
EXAMPLES
Exempel 1: Skapa ett standardprogram
Det här kommandot skapar ett standardprogram i Konfigurationshanteraren.
New-CMProgram -PackageName "test" -StandardProgramName SPM -CommandLine "RunMe" -WorkingDirectory "C:\temp" -RunType Hidden -ProgramRunType OnlyWhenNoUserIsLoggedOn -DiskSpaceRequirement 100 -DiskSpaceUnit GB -Duration 100 -DriveMode RunWithUnc
Exempel 2: Skapa ett enhetsprogram
Det här kommandot skapar ett enhetsprogram i Konfigurationshanteraren.
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
Ange en eller flera operativsystemplattformar som ska läggas till för programmet. Hämta det här objektet med hjälp av cmdleten Get-CMSupportedPlatform.
Type: IResultObject[]
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases: AddSupportedOperatingSystemPlatforms
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CommandLine
Ange kommandoraden för programmet.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CommandLineFolder
Ange den mapp som innehåller det körbara programmet. Den här mappen kan vara en absolut sökväg på klienten eller en sökväg i förhållande till distributionsmappen som innehåller paketet.
Type: String
Parameter Sets: NewDeviceProgram, NewDeviceProgramById
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Kommentar
Ange valfri text om programmet, till exempel en beskrivning. På klientdatorer visas den här texten med programmet i 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
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-DeviceProgramName
Anger ett enhetsprogramnamn.
Type: String
Parameter Sets: NewDeviceProgram, NewDeviceProgramById
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Den här parametern behandlar jokertecken som värden för literaltecken. Du kan inte kombinera den med ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DiskSpaceRequirement
Ange hur mycket diskutrymme som programvaran kräver för att köras på datorn. Värdet måste vara större än eller lika med noll. Om du anger ett värde använder du parametern DiskSpaceUnit för att ange enheter för värdet.
Type: String
Parameter Sets: (All)
Aliases: DiskSpaceReq
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DiskSpaceUnit
Ange en godkänd enhet för parametern 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
Ange när programmet ska köras.
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
Om du använder parametern DriveMode anger du en enhetsbeteckning för platsen.
Type: String
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DriveMode
Anger om programmet kräver en specifik enhetsbeteckning som anges i parametern DriveLetter.
RunWithUnc: Kör programmet från UNC-sökvägen. Detta värde är standard. Från och med version 2010 har det här värdet bytt namn frånRenameWithUnc.RequiresDriveLetter: Programmet använder alla tillgängliga enhetsbeteckningar.RequiresSpecificDriveLetter: Programmet körs bara om enheten inte redan används.
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 (Varaktighet)
Anger den maximala tid som du förväntar dig att programmet ska köras. Standardvärdet är 120 minuter.
Type: Int32
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Den här parametern bearbetar jokertecken och kan leda till oväntat beteende (rekommenderas inte). Du kan inte kombinera den med DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PackageId
Ange ID för paketet för det här programmet.
Type: String
Parameter Sets: NewStandardProgramById, NewDeviceProgramById
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PackageName
Ange ett paketnamn för det här programmet.
Type: String
Parameter Sets: NewStandardProgram, NewDeviceProgram
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ProgramRunType
Anger de inloggningsvillkor som krävs för att programmet ska kunna köras.
Standardinställningen är 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
-Återansluta
Anger om klientdatorn återansluter till distributionsplatsen när användaren loggar in på Windows.
Type: Boolean
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Krav
Anger ytterligare krav för standard- eller enhetsprogram.
Type: String
Parameter Sets: NewDeviceProgram, NewDeviceProgramById
Aliases: Requirements
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RunMode
Ange de autentiseringsuppgifter som programmet kräver för att köras på klientdatorn.
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
Ange i vilket läge programmet ska köras på klientdatorn.
Standardvärdet är 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
Ange standardprogramnamnet.
Type: String
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UserInteraction
Anger om användarna ska kunna interagera med programmet.
Type: Boolean
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-WorkingDirectory
Ange en arbetskatalog för programmet.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Denna cmdlet har stöd för parametrarna -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.