New-CMProgram

  • Riferimento
Modulo:
ConfigurationManager

Creare un nuovo programma per un pacchetto.

Sintassi

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>]
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>]
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>]
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>]

Descrizione

Usare questo cmdlet per creare un programma per un pacchetto. I programmi sono comandi associati a un pacchetto di Configuration Manager. Identificano le azioni che si verificano quando il client riceve il pacchetto client. È possibile associare più programmi allo stesso pacchetto. Per altre informazioni, vedere 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 altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Creare un programma

In questo esempio i parametri del cmdlet vengono innanzitutto inseriti nella variabile parameters . Non è necessario eseguire lo splat dei parametri, ma semplifica la lettura dei parametri per una riga di comando così lunga.

Questo comando crea un programma denominato Scan x64 nel pacchetto predefinito User State Migration Tool for Windows .

$parameters = @{
  PackageName = "User State Migration Tool for Windows"
  StandardProgramName = "Scan x64"
  CommandLine = "amd64\scanstate.exe \\gold\sources$\userdata /i:miguser.xml /i:migapp.xml /o"
  RunType = "Normal"
  ProgramRunType = "OnlyWhenNoUserIsLoggedOn"
  DiskSpaceRequirement = 200
  DiskSpaceUnit = "MB"
  Duration = 100
  DriveMode = "RunWithUnc"
}
New-CMProgram @parameters

Parametri

-AddSupportedOperatingSystemPlatform

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

Tipo:IResultObject[]
Alias:AddSupportedOperatingSystemPlatforms
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CommandLine

Specificare la riga di comando per il programma.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Comment

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeviceProgramName

Specifica il nome di un programma del dispositivo.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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, usare il parametro DiskSpaceUnit per specificare le unità per il valore.

Tipo:String
Alias:DiskSpaceReq
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DiskSpaceUnit

Specificare un'unità accettata per il parametro DiskSpaceRequirement .

Tipo:DiskSpaceUnitType
Valori accettati:KB, MB, GB
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DownloadProgramType

Specificare quando deve essere eseguito il programma.

Tipo:DownloadProgramType
Valori accettati:AsSoonAsPossible, OnlyOverFastNetwork, OnlyWhenTheDeviceIsDocked
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DriveLetter

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

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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 usa qualsiasi lettera di unità disponibile.

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

Tipo:DriveModeType
Valori accettati:RunWithUnc, RequiresDriveLetter, RequiresSpecificDriveLetter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Duration

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

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PackageId

Specificare l'ID del pacchetto per questo programma.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PackageName

Specificare un nome di pacchetto per questo programma.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ProgramRunType

Specifica le condizioni di accesso necessarie per l'esecuzione del programma.

L'impostazione predefinita è OnlyWhenUserIsLoggedOn.

Tipo:ProgramRunType
Valori accettati:OnlyWhenUserIsLoggedOn, WhetherOrNotUserIsLoggedOn, OnlyWhenNoUserIsLoggedOn
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Reconnect

Indica se il computer client si riconnette al punto di distribuzione quando l'utente accede a Windows.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Requirement

Specifica i requisiti aggiuntivi per i programmi standard o per i dispositivi.

Tipo:String
Alias:Requirements
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RunMode

Specificare le credenziali necessarie per l'esecuzione del programma nel computer client.

Tipo:RunModeType
Valori accettati:RunWithUserRights, RunWithAdministrativeRights
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RunType

Specificare la modalità di esecuzione del programma nel computer client.

Il valore predefinito è Normal.

Tipo:RunType
Valori accettati:Normal, Minimized, Maximized, Hidden
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-StandardProgramName

Specificare il nome del programma standard.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-UserInteraction

Indica se consentire agli utenti di interagire con il programma.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WorkingDirectory

Specificare una directory di lavoro per il programma.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

IResultObject

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_Program classe WMI del server.