New-CMProgram

  • Referência
Módulo:
ConfigurationManager

Crie um novo programa para um pacote.

Sintaxe

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

Utilize este cmdlet para criar um programa para um pacote. Os programas são comandos associados a um pacote do Configuration Manager. Identificam as ações que ocorrem quando o cliente recebe o pacote de cliente. Pode associar vários programas ao mesmo pacote. Para obter mais informações, veja Pacotes e programas no Configuration Manager.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Criar um programa

Este exemplo introduz primeiro os parâmetros do cmdlet na variável parameters . Não é necessário alterar os parâmetros, apenas facilita a leitura dos parâmetros para uma linha de comandos tão longa.

Este comando cria um programa com o nome Scan x64 no pacote predefinido 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 uma ou mais plataformas de SO suportadas a adicionar para o programa. Para obter este objeto, utilize o cmdlet Get-CMSupportedPlatform .

Tipo:IResultObject[]
Aliases:AddSupportedOperatingSystemPlatforms
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CommandLine

Especifique a linha de comandos do programa.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CommandLineFolder

Especifique a pasta que contém o programa executável. Esta pasta pode ser um caminho absoluto no cliente ou um caminho relativo à pasta de distribuição que contém o pacote.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Comment

Especifique texto opcional sobre o programa, como uma descrição. Nos computadores cliente, este texto é apresentado com o programa no Centro de Software.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeviceProgramName

Especifica um nome de programa de dispositivo.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DiskSpaceRequirement

Especifique a quantidade de espaço em disco que o programa de software necessita para ser executado no computador. O valor tem de ser maior ou igual a zero. Se especificar um valor, utilize o parâmetro DiskSpaceUnit para especificar unidades para o valor.

Tipo:String
Aliases:DiskSpaceReq
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DiskSpaceUnit

Especifique uma unidade aceite para o parâmetro DiskSpaceRequirement .

Tipo:DiskSpaceUnitType
Valores aceitos:KB, MB, GB
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DownloadProgramType

Especifique quando é que o programa vai ser executado.

Tipo:DownloadProgramType
Valores aceitos:AsSoonAsPossible, OnlyOverFastNetwork, OnlyWhenTheDeviceIsDocked
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DriveLetter

Se utilizar o parâmetro DriveMode , especifique uma letra de unidade para a localização.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DriveMode

Indica se o programa necessita de uma letra de unidade específica, especificada no parâmetro DriveLetter .

  • RunWithUnc: execute o programa a partir do caminho UNC. Este valor é a predefinição. A partir da versão 2010, este valor foi mudado RenameWithUncde .

  • RequiresDriveLetter: o programa utiliza qualquer letra de unidade disponível.

  • RequiresSpecificDriveLetter: o programa só é executado se a unidade ainda não estiver a ser utilizada.

Tipo:DriveModeType
Valores aceitos:RunWithUnc, RequiresDriveLetter, RequiresSpecificDriveLetter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Duration

Especifica o período máximo de tempo que espera que o programa seja executado. O valor padrão é 120 minutos.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PackageId

Especifique o ID do pacote para este programa.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PackageName

Especifique um nome de pacote para este programa.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ProgramRunType

Especifica as condições de início de sessão necessárias para a execução do programa.

A predefinição é OnlyWhenUserIsLoggedOn.

Tipo:ProgramRunType
Valores aceitos:OnlyWhenUserIsLoggedOn, WhetherOrNotUserIsLoggedOn, OnlyWhenNoUserIsLoggedOn
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Reconnect

Indica se o computador cliente volta a ligar ao ponto de distribuição quando o utilizador inicia sessão no Windows.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Requirement

Especifica requisitos adicionais para programas padrão ou de dispositivo.

Tipo:String
Aliases:Requirements
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunMode

Especifique as credenciais de que o programa necessita para ser executado no computador cliente.

Tipo:RunModeType
Valores aceitos:RunWithUserRights, RunWithAdministrativeRights
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunType

Especifique o modo no qual o programa é executado no computador cliente.

O valor padrão é Normal.

Tipo:RunType
Valores aceitos:Normal, Minimized, Maximized, Hidden
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-StandardProgramName

Especifique o nome do programa padrão.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UserInteraction

Indica se deve permitir que os utilizadores interajam com o programa.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WorkingDirectory

Especifique um diretório de trabalho para o programa.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

IResultObject

Observações

Para obter mais informações sobre este objeto de retorno e as respetivas propriedades, veja SMS_Program classe WMI de servidor.