Udostępnij za pośrednictwem

New-CMProgram

  • Artykuł

SYNOPSIS

Utwórz nowy program dla pakietu.

SYNTAX

NewStandardProgram (ustawienie domyślne)

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

Polecenie cmdlet New-CMProgram tworzy program w Menedżer konfiguracji. Programy to polecenia, które są skojarzone z Menedżer konfiguracji pakietem. Programy identyfikują akcje, które występują, gdy klient odbiera pakiet klienta. Z tym samym pakietem można skojarzyć wiele programów.

Uwaga

Uruchom Menedżer konfiguracji cmdlet z dysku Menedżer konfiguracji lokacji, na przykład PS XYZ:\> . Aby uzyskać więcej informacji, zobacz wprowadzenie.

EXAMPLES

Przykład 1: Tworzenie programu standardowego

To polecenie tworzy standardowy program w Menedżer konfiguracji.

New-CMProgram -PackageName "test" -StandardProgramName SPM -CommandLine "RunMe" -WorkingDirectory "C:\temp" -RunType Hidden -ProgramRunType OnlyWhenNoUserIsLoggedOn -DiskSpaceRequirement 100 -DiskSpaceUnit GB -Duration 100 -DriveMode RunWithUnc

Przykład 2: Tworzenie programu urządzenia

To polecenie tworzy program urządzenia w Menedżer konfiguracji.

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

Określ co najmniej jedną obsługiwaną platformę systemu operacyjnego do dodania dla programu. Aby uzyskać ten obiekt, użyj polecenia cmdlet 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

Określ wiersz polecenia programu.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-CommandLineFolder

Określ folder zawierający program wykonywalny. Ten folder może być ścieżką bezwzględną na kliencie lub ścieżką względną do folderu dystrybucji, który zawiera pakiet.

Type: String
Parameter Sets: NewDeviceProgram, NewDeviceProgramById
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Komentarz

Podaj opcjonalny tekst programu, na przykład opis. Na komputerach klienckich ten tekst jest wyświetlany wraz z programem w Centrum oprogramowania.

Type: String
Parameter Sets: NewDeviceProgram, NewDeviceProgramById
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-DeviceProgramName

Określa nazwę programu urządzenia.

Type: String
Parameter Sets: NewDeviceProgram, NewDeviceProgramById
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DisableWildcardHandling

Ten parametr traktuje symbole wieloznaczne jako wartości znaków literału. Nie można połączyć go z forceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DiskSpaceRequirement

Określ ilość miejsca na dysku wymaganego przez program do uruchomienia na komputerze. Wartość musi być większa niż lub równa zero. Jeśli określisz wartość, użyj parametru DiskSpaceUnit, aby określić jednostki dla wartości.

Type: String
Parameter Sets: (All)
Aliases: DiskSpaceReq

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DiskSpaceUnit

Określ akceptowaną jednostkę dla parametru 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

Określ, kiedy program ma być uruchamiany.

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

Jeśli używasz driveMode parametru, określ literę dysku dla lokalizacji.

Type: String
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DriveMode

Wskazuje, czy program wymaga określonej litery dysku, określonej w driveLetter parametru.

  • RunWithUnc: uruchom program ze ścieżki UNC. Ta wartość jest domyślna. Począwszy od wersji 2010, nazwa tej wartości została zmieniona z RenameWithUnc .

  • RequiresDriveLetter: program używa dowolnej dostępnej litery dysku.

  • RequiresSpecificDriveLetter: program jest uruchamiany tylko wtedy, gdy dysk nie jest jeszcze w użyciu.

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 (Czas trwania)

Określa maksymalny czas, przez który program ma być uruchamiany. Wartość domyślna to 120 minut.

Type: Int32
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ForceWildcardHandling

Ten parametr przetwarza symbole wieloznaczne i może prowadzić do nieoczekiwanego zachowania (nie jest zalecane). Nie można połączyć go z disableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PackageId

Określ identyfikator pakietu dla tego programu.

Type: String
Parameter Sets: NewStandardProgramById, NewDeviceProgramById
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-PackageName

Określ nazwę pakietu dla tego programu.

Type: String
Parameter Sets: NewStandardProgram, NewDeviceProgram
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ProgramRunType

Określa warunki logowania, które są niezbędne do uruchomienia programu.

Ustawienie domyślne to 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

-Ponownie nawiąz

Wskazuje, czy komputer kliencki łączy się ponownie z punktem dystrybucji, gdy użytkownik się Windows.

Type: Boolean
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

- Wymaganie

Określa dodatkowe wymagania dotyczące programów standardowych lub urządzeń.

Type: String
Parameter Sets: NewDeviceProgram, NewDeviceProgramById
Aliases: Requirements

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-RunMode

Określ poświadczenia wymagane przez program do uruchomienia na komputerze klienckim.

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

Określ tryb, w którym program jest uruchamiany na komputerze klienckim.

Wartość domyślna to 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

Określ standardową nazwę programu.

Type: String
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UserInteraction

Wskazuje, czy zezwolić użytkownikom na interakcję z programem.

Type: Boolean
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-WorkingDirectory

Określ katalog roboczy dla programu.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Typowe parametry

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

INPUTS

Brak

OUTPUTS

IResultObject#SMS_Program

UWAGI

Disable-CMProgram

Enable-CMProgram

Get-CMProgram

Remove-CMProgram

Set-CMProgram