New-CMProgram
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 deRenameWithUnc.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.