Set-CMProgram

Modulo:

ConfigurationManager

Modificare un programma di un pacchetto.

Sintassi

Set-CMProgram
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-AfterRunningType <AfterRunningType>]
   [-Category <String>]
   [-CommandLine <String>]
   [-Comment <String>]
   [-DisableMomAlertOnRun <Boolean>]
   [-DisableProgram <Boolean>]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DriveLetter <String>]
   [-DriveMode <DriveModeType>]
   [-Duration <Int32>]
   [-EnableTaskSequence <Boolean>]
   [-GenerateMomAlertOnFail <Boolean>]
   -InputObject <IResultObject>
   [-PassThru]
   [-ProgramAssignedType <ProgramAssignedType>]
   [-ProgramRunType <ProgramRunType>]
   [-Reconnect <Boolean>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-Requirement <String>]
   [-RunMode <RunModeType>]
   [-RunOnAnyPlatform]
   [-RunType <RunType>]
   [-StandardProgram]
   [-SuppressProgramNotification <Boolean>]
   [-UserInteraction <Boolean>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMProgram
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-AfterRunningType <AfterRunningType>]
   [-Category <String>]
   [-CommandLine <String>]
   [-Comment <String>]
   [-DisableMomAlertOnRun <Boolean>]
   [-DisableProgram <Boolean>]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DriveLetter <String>]
   [-DriveMode <DriveModeType>]
   [-Duration <Int32>]
   [-EnableTaskSequence <Boolean>]
   [-GenerateMomAlertOnFail <Boolean>]
   -PackageName <String>
   [-PassThru]
   [-ProgramAssignedType <ProgramAssignedType>]
   -ProgramName <String>
   [-ProgramRunType <ProgramRunType>]
   [-Reconnect <Boolean>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-Requirement <String>]
   [-RunMode <RunModeType>]
   [-RunOnAnyPlatform]
   [-RunType <RunType>]
   [-StandardProgram]
   [-SuppressProgramNotification <Boolean>]
   [-UserInteraction <Boolean>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMProgram
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-AfterRunningType <AfterRunningType>]
   [-Category <String>]
   [-CommandLine <String>]
   [-Comment <String>]
   [-DisableMomAlertOnRun <Boolean>]
   [-DisableProgram <Boolean>]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DriveLetter <String>]
   [-DriveMode <DriveModeType>]
   [-Duration <Int32>]
   [-EnableTaskSequence <Boolean>]
   [-GenerateMomAlertOnFail <Boolean>]
   -PackageId <String>
   [-PassThru]
   [-ProgramAssignedType <ProgramAssignedType>]
   -ProgramName <String>
   [-ProgramRunType <ProgramRunType>]
   [-Reconnect <Boolean>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-Requirement <String>]
   [-RunMode <RunModeType>]
   [-RunOnAnyPlatform]
   [-RunType <RunType>]
   [-StandardProgram]
   [-SuppressProgramNotification <Boolean>]
   [-UserInteraction <Boolean>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMProgram
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-AfterRunningType <AfterRunningType>]
   [-Category <String>]
   [-CommandLine <String>]
   [-Comment <String>]
   [-DisableMomAlertOnRun <Boolean>]
   [-DisableProgram <Boolean>]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DriveLetter <String>]
   [-DriveMode <DriveModeType>]
   [-Duration <Int32>]
   [-EnableTaskSequence <Boolean>]
   [-GenerateMomAlertOnFail <Boolean>]
   -InputObject <IResultObject>
   [-PassThru]
   [-ProgramAssignedType <ProgramAssignedType>]
   -ProgramName <String>
   [-ProgramRunType <ProgramRunType>]
   [-Reconnect <Boolean>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-Requirement <String>]
   [-RunMode <RunModeType>]
   [-RunOnAnyPlatform]
   [-RunType <RunType>]
   [-StandardProgram]
   [-SuppressProgramNotification <Boolean>]
   [-UserInteraction <Boolean>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMProgram
   [-CommandLine <String>]
   [-CommandLineFolder <String>]
   [-Comment <String>]
   [-DeviceProgram]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DownloadProgramType <DownloadProgramType>]
   -PackageName <String>
   [-PassThru]
   -ProgramName <String>
   [-Requirement <String>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMProgram
   [-CommandLine <String>]
   [-CommandLineFolder <String>]
   [-Comment <String>]
   [-DeviceProgram]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DownloadProgramType <DownloadProgramType>]
   -PackageId <String>
   [-PassThru]
   -ProgramName <String>
   [-Requirement <String>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMProgram
   [-CommandLine <String>]
   [-CommandLineFolder <String>]
   [-Comment <String>]
   [-DeviceProgram]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DownloadProgramType <DownloadProgramType>]
   -InputObject <IResultObject>
   [-PassThru]
   -ProgramName <String>
   [-Requirement <String>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMProgram
   [-CommandLine <String>]
   [-CommandLineFolder <String>]
   [-Comment <String>]
   [-DeviceProgram]
   [-DiskSpaceRequirement <String>]
   [-DiskSpaceUnit <DiskSpaceUnitType>]
   [-DownloadProgramType <DownloadProgramType>]
   -InputObject <IResultObject>
   [-PassThru]
   [-Requirement <String>]
   [-WorkingDirectory <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Utilizzare questo cmdlet per modificare un programma di un pacchetto. I programmi identificano le azioni che si verificano quando il client riceve il pacchetto client. È possibile associare più programmi allo stesso pacchetto. Per altre informazioni, vedi Pacchetti e programmi in Configuration Manager.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\> . Per ulteriori informazioni, vedere Introduzione.

Esempio

Esempio 1: Modificare un programma standard

Set-CMProgram -Name "Test" -StandardProgramName SPM -Comment "Standard Upgrades" -CommandLine "RunThisNow" -RunType Maximized -AfterRunningType ProgramControlsRestart -Category "Laptops" -DiskSpaceRequirement 50 -DiskSpaceUnit MB -Duration 150 -Requirement 4 -Reconnect $False -SuppressProgramNotifications $False -DisableProgram $True -EnableTaskSequence $True -DisableMomAlertOnRun $True -GenerateMomAlertOnFail $True

Esempio 2: Modificare un programma per dispositivi

Set-CMProgram -Name "Test" -DeviceProgramName DPM -Comment "Upgrades for December" -CommandLine "RunMe" -WorkingDirectory "\TempWork" -CommandLineFolder "C:\Windows" -DiskSpaceRequirement 30 -DiskSpaceUnit MB -DownloadProgramType AsSoonAsPossible -Requirement "All previous device updates"

Esempio 3: Aggiungere una piattaforma del sistema operativo supportata

In questo esempio viene impostato il requisito del sistema operativo per un programma associato a un pacchetto standard. Utilizza il cmdlet Get-CMSupportedPlatform per ottenere un oggetto per la piattaforma specificata. Viene quindi utilizzato questo oggetto piattaforma supportato per configurare il programma.

$ProgramName = 'Script'
$PackageID = 'XYZ0000D'
$Platform = 'All Windows 10 (64-bit) Client'
$OS = Get-CMSupportedPlatform -Name $Platform -Fast

Set-CMProgram -PackageID $PackageID -ProgramName $ProgramName -AddSupportedOperatingSystemPlatform $OS -StandardProgram

Parametri

-AddSupportedOperatingSystemPlatform

Specificare una o più piattaforme del sistema operativo supportate da aggiungere al programma. Per ottenere questo oggetto, utilizzare il cmdlet Get-CMSupportedPlatform.

Type:	IResultObject[]
Aliases:	AddSupportedOperatingSystemPlatforms
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AfterRunningType

Specificare l'azione che viene eseguita al termine del programma.

Type:	AfterRunningType
Accepted values:	NoActionRequired, ConfigurationManagerRestartsComputer, ProgramControlsRestart, ConfigurationManagerLogsUserOff
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Category

Specificare la categoria in base alla quale il programma viene visualizzato nel computer client.

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

-CommandLine

Specificare la riga di comando per il programma.

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

-CommandLineFolder

Specificare la cartella che contiene il programma eseguibile. Questa cartella può essere un percorso assoluto nel client o un percorso relativo alla cartella di distribuzione che contiene il pacchetto.

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

-Comment

Specificare un testo facoltativo sul programma, ad esempio una descrizione. Nei computer client, questo testo viene visualizzato con il programma in Software Center.

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

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DeviceProgram

Aggiungi questo parametro per configurare questo programma come programma per dispositivi.

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

-DisableMomAlertOnRun

Indica se il computer che esegue il programma è in modalità di manutenzione per la durata del programma. In modalità manutenzione, System Center Operations Manager disabilita gli avvisi durante l'esecuzione del programma.

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

-DisableProgram

Impostare questo parametro su $true per disabilitare temporaneamente tutte le distribuzioni che contengono questo programma. È inoltre possibile utilizzare il cmdlet Disable-CMProgram.

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

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

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

-DiskSpaceRequirement

Specificare la quantità di spazio su disco necessaria per l'esecuzione del programma software nel computer. Il valore deve essere maggiore o uguale a zero. Se si specifica un valore, utilizzare il parametro DiskSpaceUnit per specificare le unità per il valore.

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

-DiskSpaceUnit

Specificare un'unità accettata per il parametro DiskSpaceRequirement.

Type:	DiskSpaceUnitType
Accepted values:	KB, MB, GB
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DownloadProgramType

Specificare quando deve essere eseguito il programma.

Type:	DownloadProgramType
Accepted values:	AsSoonAsPossible, OnlyOverFastNetwork, OnlyWhenTheDeviceIsDocked
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DriveLetter

Se si utilizza il parametro DriveMode, specificare una lettera di unità per la posizione.

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

-DriveMode

Indica se il programma richiede una lettera di unità specifica, specificata nel parametro DriveLetter.

• RunWithUnc: eseguire il programma dal percorso UNC. Questo valore è il valore predefinito. A partire dalla versione 2010, questo valore è stato rinominato da RenameWithUnc .

• RequiresDriveLetter: il programma utilizza qualsiasi lettera di unità disponibile.

• RequiresSpecificDriveLetter: il programma viene eseguito solo se l'unità non è già in uso.

Type:	DriveModeType
Accepted values:	RunWithUnc, RequiresDriveLetter, RequiresSpecificDriveLetter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Duration

Specifica la quantità massima di tempo prevista per l'esecuzione del programma. Il valore predefinito è 120 minuti.

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

-EnableTaskSequence

Indica se questo programma può essere installato dal passaggio della sequenza di attività Installa pacchetto.

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

-ForceWildcardHandling

Questo parametro elabora i caratteri jolly e può causare un comportamento imprevisto (scelta non consigliata). Non è possibile combinarlo con DisableWildcardHandling.

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

-GenerateMomAlertOnFail

Indica se Configuration Manager genera una voce di evento del registro applicazioni se il programma ha esito negativo.

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

-InputObject

Specificare un oggetto programma da configurare. Per ottenere questo oggetto, utilizzare il cmdlet Get-CMProgram.

Type:	IResultObject
Aliases:	ProgramPackage, Package, Program
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-PackageId

Specificare un ID pacchetto con il programma da configurare.

Type:	String
Aliases:	Id
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PackageName

Specificare un nome di pacchetto con il programma da configurare.

Type:	String
Aliases:	Name
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Restituisce un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.

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

-ProgramAssignedType

Specificare se il programma viene eseguito una volta nel computer o una sola volta per ogni utente che accede al computer. Il valore predefinito è RunOnceForTheComputer. Il programma viene assegnato agli utenti solo quando il parametro ProgramRunType è impostato su OnlyWhenUserIsLoggedOn .

Type:	ProgramAssignedType
Accepted values:	RunOnceForTheComputer, RunOnceForEveryUserWhoLogsOn
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ProgramName

Specificare il nome del programma da configurare.

Type:	String
Aliases:	StandardProgramName, DeviceProgramName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ProgramRunType

Specificare le condizioni di accesso necessarie per l'esecuzione del programma. Il valore predefinito è OnlyWhenUserIsLoggedOn.

Type:	ProgramRunType
Accepted values:	OnlyWhenUserIsLoggedOn, WhetherOrNotUserIsLoggedOn, OnlyWhenNoUserIsLoggedOn
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Reconnect

Indica se il computer client si riconnette al punto di distribuzione quando l'utente esegue l'accesso.

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

-RemoveSupportedOperatingSystemPlatform

Specificare una o più piattaforme del sistema operativo supportate da rimuovere per il programma. Per ottenere questo oggetto, utilizzare il cmdlet Get-CMSupportedPlatform.

Type:	IResultObject[]
Aliases:	RemoveSupportedOperatingSystemPlatforms
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Requirement

Specificare eventuali requisiti aggiuntivi per i programmi standard o per i dispositivi.

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

-RunMode

Specificare le credenziali necessarie al computer client per eseguire il programma.

Type:	RunModeType
Accepted values:	RunWithUserRights, RunWithAdministrativeRights
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RunOnAnyPlatform

Aggiungi questo parametro per cancellare tutte le piattaforme del sistema operativo supportate da questo programma.

Type:	SwitchParameter
Aliases:	ClearSupportedOperatingSystemPlatforms
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RunType

Specificare la modalità di esecuzione del programma nel computer client. Il valore predefinito è Normal.

Type:	RunType
Accepted values:	Normal, Minimized, Maximized, Hidden
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-StandardProgram

Indica che il tipo di programma nel pacchetto di distribuzione è un programma standard.

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

-SuppressProgramNotification

Impostare questo parametro su per $true eliminare le notifiche del programma.

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

-UserInteraction

Indica se consentire agli utenti di interagire con il programma.

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

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WorkingDirectory

Specificare una directory di lavoro per il programma.

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

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object

Collegamenti correlati

• Disable-CMProgram
• Enable-CMProgram
• Get-CMProgram
• New-CMProgram
• Remove-CMProgram
• Pacchetti e programmi in Configuration Manager