New-CMProgram

  • Artigo

SYNOPSIS

Crie um novo programa para um pacote.

SYNTAX

Novo Programa De Padrard (Padrão)

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

Novo Programa deDevice

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

O cmdlet Novo-CMProgram cria um programa no Gestor de Configuração. Os programas são comandos associados a um pacote de Gestor de Configuração. Os programas identificam as ações que ocorrem quando o cliente recebe o pacote do cliente. Pode associar vários programas com o mesmo pacote.

Nota

Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.

EXAMPLES

Exemplo 1: Criar um programa padrão

Este comando cria um programa padrão no Gestor de Configuração.

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

Exemplo 2: Criar um programa de dispositivos

Este comando cria um programa de dispositivo no Gestor de Configuração.

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

Especifique uma ou mais plataformas de SO suportadas para adicionar para o programa. Para obter este objeto, utilize o 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

-Linha de Comando

Especifique a linha de comando para o programa.

Type: String
Parameter Sets: (All)
Aliases:

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

-CommandLineFolder

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

Type: String
Parameter Sets: NewDeviceProgram, NewDeviceProgramById
Aliases:

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

-Comentário

Especifique texto opcional sobre o programa, como uma descrição. Nos computadores clientes, este texto apresenta-se com o programa no Software Center.

Type: String
Parameter Sets: NewDeviceProgram, NewDeviceProgramById
Aliases:

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

-Confirm

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

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

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

-DeviceProgramName

Especifica o nome do programa do dispositivo.

Type: String
Parameter Sets: NewDeviceProgram, NewDeviceProgramById
Aliases:

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

-DisableWildcardHandling

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-DiskSpaceRequirement

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

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

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

-DiskSpaceUnit

Especifique uma unidade aceite para o parâmetro 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

Especificar quando o programa deve ser executado.

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

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

Type: String
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:

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

-DriveMode

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

  • RunWithUnc: Executar o programa a partir do caminho do UNC. este valor é a predefinição. A partir da versão 2010, este valor foi renomeado de RenameWithUnc .

  • RequiresDriveLetter: O programa utiliza qualquer letra de acionamento disponível.

  • RequiresSpecificDriveLetter: O programa só funciona se a unidade já não estiver a ser utilizada.

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

-Duração

Especifica o tempo máximo que espera que o programa seja executado. O valor predefinido é de 120 minutos.

Type: Int32
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:

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

-ForceWildcardHandling

Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-PackageId

Especifique o ID do pacote para este programa.

Type: String
Parameter Sets: NewStandardProgramById, NewDeviceProgramById
Aliases:

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

-Nome do pacote

Especifique um nome de pacote para este programa.

Type: String
Parameter Sets: NewStandardProgram, NewDeviceProgram
Aliases:

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

-ProgramRunType

Especifica as condições de início de saúde necessárias para que o programa seja executado.

A predefinição é 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

-Reconectar

Indica se o computador cliente reconecta-se ao ponto de distribuição quando o utilizador assina para Windows.

Type: Boolean
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:

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

-Requisito

Especifica requisitos adicionais para programas standard ou dispositivo.

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

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

-RunMode

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

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

Especifique o modo em que o programa é executado no computador cliente.

O valor predefinido é 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

Especifique o nome do programa padrão.

Type: String
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:

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

-Utilização

Indica se permite que os utilizadores interajam com o programa.

Type: Boolean
Parameter Sets: NewStandardProgram, NewStandardProgramById
Aliases:

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

- O QueIf

Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.

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

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

-WorkingDirectory

Especifique um diretório de trabalho para o programa.

Type: String
Parameter Sets: (All)
Aliases:

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

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.

INPUTS

Nenhuma

OUTPUTS

IResultObject#SMS_Program

NOTAS

Programa DE Desativação CM

Ativar-CMPrograma

Get-CMPrograma

Remover-CMPrograma

Set-CMPrograma