New-CMProgram

Módulo:

ConfigurationManager

Cree un nuevo programa para un paquete.

Sintaxis

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

Description

Use este cmdlet para crear un programa para un paquete. Los programas son comandos asociados a un paquete de Configuration Manager. Identifican las acciones que se producen cuando el cliente recibe el paquete de cliente. Puede asociar varios programas con el mismo paquete. Para obtener más información, vea Paquetes y programas en Configuration Manager.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Creación de un programa

En este ejemplo, primero se salpican los parámetros del cmdlet en la variable parameters . No es necesario salpicar los parámetros, simplemente facilita la lectura de los parámetros de una línea de comandos tan larga.

Este comando crea un programa denominado Scan x64 en el paquete predeterminado 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

Parámetros

-AddSupportedOperatingSystemPlatform

Especifique una o varias plataformas de sistema operativo compatibles que se van a agregar para el programa. Para obtener este objeto, use el cmdlet Get-CMSupportedPlatform .

Tipo:	IResultObject[]
Alias:	AddSupportedOperatingSystemPlatforms
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CommandLine

Especifique la línea de comandos del programa.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CommandLineFolder

Especifique la carpeta que contiene el programa ejecutable. Esta carpeta puede ser una ruta de acceso absoluta en el cliente o una ruta de acceso relativa a la carpeta de distribución que contiene el paquete.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Comment

Especifique texto opcional sobre el programa, como una descripción. En los equipos cliente, este texto se muestra con el programa en el Centro de software.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DeviceProgramName

Especifica un nombre de programa de dispositivo.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DiskSpaceRequirement

Especifique la cantidad de espacio en disco que requiere el programa de software para ejecutarse en el equipo. El valor debe ser mayor o igual que cero. Si especifica un valor, use el parámetro DiskSpaceUnit para especificar unidades para el valor.

Tipo:	String
Alias:	DiskSpaceReq
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DiskSpaceUnit

Especifique una unidad aceptada para el parámetro DiskSpaceRequirement .

Tipo:	DiskSpaceUnitType
Valores aceptados:	KB, MB, GB
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DownloadProgramType

Especifique cuándo se va a ejecutar el programa.

Tipo:	DownloadProgramType
Valores aceptados:	AsSoonAsPossible, OnlyOverFastNetwork, OnlyWhenTheDeviceIsDocked
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DriveLetter

Si usa el parámetro DriveMode , especifique una letra de unidad para la ubicación.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DriveMode

Indica si el programa requiere una letra de unidad específica, especificada en el parámetro DriveLetter .

• RunWithUnc: ejecute el programa desde la ruta de acceso UNC. Este valor es el predeterminado. A partir de la versión 2010, se cambió el nombre de este valor por RenameWithUnc.

• RequiresDriveLetter: el programa usa cualquier letra de unidad disponible.

• RequiresSpecificDriveLetter: el programa solo se ejecuta si la unidad aún no está en uso.

Tipo:	DriveModeType
Valores aceptados:	RunWithUnc, RequiresDriveLetter, RequiresSpecificDriveLetter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Duration

Especifica la cantidad máxima de tiempo que espera que se ejecute el programa. El valor predeterminado es 120 minutos.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PackageId

Especifique el identificador del paquete para este programa.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-PackageName

Especifique un nombre de paquete para este programa.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ProgramRunType

Especifica las condiciones de inicio de sesión necesarias para que se ejecute el programa.

La configuración predeterminada es OnlyWhenUserIsLoggedOn.

Tipo:	ProgramRunType
Valores aceptados:	OnlyWhenUserIsLoggedOn, WhetherOrNotUserIsLoggedOn, OnlyWhenNoUserIsLoggedOn
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Reconnect

Indica si el equipo cliente se vuelve a conectar al punto de distribución cuando el usuario inicia sesión en Windows.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Requirement

Especifica requisitos adicionales para los programas estándar o de dispositivo.

Tipo:	String
Alias:	Requirements
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RunMode

Especifique las credenciales que el programa requiere para ejecutarse en el equipo cliente.

Tipo:	RunModeType
Valores aceptados:	RunWithUserRights, RunWithAdministrativeRights
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RunType

Especifique el modo en el que se ejecuta el programa en el equipo cliente.

El valor predeterminado es Normal.

Tipo:	RunType
Valores aceptados:	Normal, Minimized, Maximized, Hidden
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-StandardProgramName

Especifique el nombre del programa estándar.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-UserInteraction

Indica si se va a permitir que los usuarios interactúen con el programa.

Tipo:	Boolean
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	False
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WorkingDirectory

Especifique un directorio de trabajo para el programa.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

None

Salidas

IResultObject

Notas

Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_Program clase WMI de servidor.

Vínculos relacionados

• Disable-CMProgram
• Enable-CMProgram
• Get-CMProgram
• Remove-CMProgram
• Set-CMProgram
• Paquetes y programas en Configuration Manager