Set-CMProgram

  • Artigo

SYNOPSIS

Modificar um programa no Gestor de Configuração.

SYNTAX

SetStandardProgramByProgramValue (Padrão)

Set-CMProgram [-AddSupportedOperatingSystemPlatform <IResultObject[]>] [-AfterRunningType <AfterRunningType>]
 [-Category <String>] [-CommandLine <String>] [-Comment <String>] [-DisableMomAlertOnRun <Boolean>]
 [-DisableProgram <Boolean>] [-DiskSpaceRequirement <String>] [-DiskSpaceUnit <DiskSpaceUnitType>]
 [-DriveLetter <String>] [-DriveMode <DriveModeType>] [-Duration <Int32>] [-EnableTaskSequence <Boolean>]
 [-GenerateMomAlertOnFail <Boolean>] -InputObject <IResultObject> [-PassThru]
 [-ProgramAssignedType <ProgramAssignedType>] [-ProgramRunType <ProgramRunType>] [-Reconnect <Boolean>]
 [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>] [-Requirement <String>] [-RunMode <RunModeType>]
 [-RunOnAnyPlatform] [-RunType <RunType>] [-StandardProgram] [-SuppressProgramNotification <Boolean>]
 [-UserInteraction <Boolean>] [-WorkingDirectory <String>] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

SetStandardProgramByName

Set-CMProgram [-AddSupportedOperatingSystemPlatform <IResultObject[]>] [-AfterRunningType <AfterRunningType>]
 [-Category <String>] [-CommandLine <String>] [-Comment <String>] [-DisableMomAlertOnRun <Boolean>]
 [-DisableProgram <Boolean>] [-DiskSpaceRequirement <String>] [-DiskSpaceUnit <DiskSpaceUnitType>]
 [-DriveLetter <String>] [-DriveMode <DriveModeType>] [-Duration <Int32>] [-EnableTaskSequence <Boolean>]
 [-GenerateMomAlertOnFail <Boolean>] -PackageName <String> [-PassThru]
 [-ProgramAssignedType <ProgramAssignedType>] -ProgramName <String> [-ProgramRunType <ProgramRunType>]
 [-Reconnect <Boolean>] [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>] [-Requirement <String>]
 [-RunMode <RunModeType>] [-RunOnAnyPlatform] [-RunType <RunType>] [-StandardProgram]
 [-SuppressProgramNotification <Boolean>] [-UserInteraction <Boolean>] [-WorkingDirectory <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetStandardProgramById

Set-CMProgram [-AddSupportedOperatingSystemPlatform <IResultObject[]>] [-AfterRunningType <AfterRunningType>]
 [-Category <String>] [-CommandLine <String>] [-Comment <String>] [-DisableMomAlertOnRun <Boolean>]
 [-DisableProgram <Boolean>] [-DiskSpaceRequirement <String>] [-DiskSpaceUnit <DiskSpaceUnitType>]
 [-DriveLetter <String>] [-DriveMode <DriveModeType>] [-Duration <Int32>] [-EnableTaskSequence <Boolean>]
 [-GenerateMomAlertOnFail <Boolean>] -PackageId <String> [-PassThru]
 [-ProgramAssignedType <ProgramAssignedType>] -ProgramName <String> [-ProgramRunType <ProgramRunType>]
 [-Reconnect <Boolean>] [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>] [-Requirement <String>]
 [-RunMode <RunModeType>] [-RunOnAnyPlatform] [-RunType <RunType>] [-StandardProgram]
 [-SuppressProgramNotification <Boolean>] [-UserInteraction <Boolean>] [-WorkingDirectory <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetStandardProgramByValue

Set-CMProgram [-AddSupportedOperatingSystemPlatform <IResultObject[]>] [-AfterRunningType <AfterRunningType>]
 [-Category <String>] [-CommandLine <String>] [-Comment <String>] [-DisableMomAlertOnRun <Boolean>]
 [-DisableProgram <Boolean>] [-DiskSpaceRequirement <String>] [-DiskSpaceUnit <DiskSpaceUnitType>]
 [-DriveLetter <String>] [-DriveMode <DriveModeType>] [-Duration <Int32>] [-EnableTaskSequence <Boolean>]
 [-GenerateMomAlertOnFail <Boolean>] -InputObject <IResultObject> [-PassThru]
 [-ProgramAssignedType <ProgramAssignedType>] -ProgramName <String> [-ProgramRunType <ProgramRunType>]
 [-Reconnect <Boolean>] [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>] [-Requirement <String>]
 [-RunMode <RunModeType>] [-RunOnAnyPlatform] [-RunType <RunType>] [-StandardProgram]
 [-SuppressProgramNotification <Boolean>] [-UserInteraction <Boolean>] [-WorkingDirectory <String>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetDeviceProgramByName

Set-CMProgram [-CommandLine <String>] [-CommandLineFolder <String>] [-Comment <String>] [-DeviceProgram]
 [-DiskSpaceRequirement <String>] [-DiskSpaceUnit <DiskSpaceUnitType>]
 [-DownloadProgramType <DownloadProgramType>] -PackageName <String> [-PassThru] -ProgramName <String>
 [-Requirement <String>] [-WorkingDirectory <String>] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

SetDeviceProgramById

Set-CMProgram [-CommandLine <String>] [-CommandLineFolder <String>] [-Comment <String>] [-DeviceProgram]
 [-DiskSpaceRequirement <String>] [-DiskSpaceUnit <DiskSpaceUnitType>]
 [-DownloadProgramType <DownloadProgramType>] -PackageId <String> [-PassThru] -ProgramName <String>
 [-Requirement <String>] [-WorkingDirectory <String>] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

SetDeviceProgramByValue

Set-CMProgram [-CommandLine <String>] [-CommandLineFolder <String>] [-Comment <String>] [-DeviceProgram]
 [-DiskSpaceRequirement <String>] [-DiskSpaceUnit <DiskSpaceUnitType>]
 [-DownloadProgramType <DownloadProgramType>] -InputObject <IResultObject> [-PassThru] -ProgramName <String>
 [-Requirement <String>] [-WorkingDirectory <String>] [-DisableWildcardHandling] [-ForceWildcardHandling]
 [-WhatIf] [-Confirm] [<CommonParameters>]

SetDeviceProgramByProgramValue

Set-CMProgram [-CommandLine <String>] [-CommandLineFolder <String>] [-Comment <String>] [-DeviceProgram]
 [-DiskSpaceRequirement <String>] [-DiskSpaceUnit <DiskSpaceUnitType>]
 [-DownloadProgramType <DownloadProgramType>] -InputObject <IResultObject> [-PassThru] [-Requirement <String>]
 [-WorkingDirectory <String>] [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm]
 [<CommonParameters>]

DESCRIPTION

O cmdlet Set-CMProgram modifica um programa no Gestor de Configurações. 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: Modificar um programa padrão

Set-CMProgram -Name "Test" -StandardProgramName SPM -Comment "Standard Upgrades" -CommandLine "RunThisNow" -RunType Maximized -AfterRunningType ProgramControlsRestart -Category "Laptops" -DiskSpaceRequirement 50 -DiskSpaceUnit MB -Duration 150 -Requirement 4 -Reconnect $False -SuppressProgramNotifications $False -DisableProgram $True -EnableTaskSequence $True -DisableMomAlertOnRun $True -GenerateMomAlertOnFail $True

Exemplo 2: Modificar um programa de dispositivos

Set-CMProgram -Name "Test" -DeviceProgramName DPM -Comment "Upgrades for December" -CommandLine "RunMe" -WorkingDirectory "\TempWork" -CommandLineFolder "C:\Windows" -DiskSpaceRequirement 30 -DiskSpaceUnit MB -DownloadProgramType AsSoonAsPossible -Requirement "All previous device 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: SetStandardProgramByProgramValue, SetStandardProgramByName, SetStandardProgramById, SetStandardProgramByValue
Aliases: AddSupportedOperatingSystemPlatforms

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

-AfterRunningType

Especifique a ação que ocorre após o fim do programa com sucesso.

Type: AfterRunningType
Parameter Sets: SetStandardProgramByProgramValue, SetStandardProgramByName, SetStandardProgramById, SetStandardProgramByValue
Aliases:
Accepted values: NoActionRequired, ConfigurationManagerRestartsComputer, ProgramControlsRestart, ConfigurationManagerLogsUserOff

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

-Categoria

Especificar a categoria em que o programa é apresentado no computador cliente.

Type: String
Parameter Sets: SetStandardProgramByProgramValue, SetStandardProgramByName, SetStandardProgramById, SetStandardProgramByValue
Aliases:

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: False
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: SetDeviceProgramByName, SetDeviceProgramById, SetDeviceProgramByValue, SetDeviceProgramByProgramValue
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: (All)
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

-Programa de Dispositivos

Adicione este parâmetro para configurar este programa como um programa de dispositivo.

Type: SwitchParameter
Parameter Sets: SetDeviceProgramByName, SetDeviceProgramById, SetDeviceProgramByValue, SetDeviceProgramByProgramValue
Aliases:

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

-DisableMomAlertOnRun

Indica se o computador que executa o programa está em modo de manutenção durante a duração do programa. Quando em modo de manutenção, System Center Gestor de Operações desativa os alertas enquanto o programa é executado.

Type: Boolean
Parameter Sets: SetStandardProgramByProgramValue, SetStandardProgramByName, SetStandardProgramById, SetStandardProgramByValue
Aliases:

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

-Programa de Desativação

Desative este parâmetro $true para desativar temporariamente todas as implementações que contenham este programa.

Type: Boolean
Parameter Sets: SetStandardProgramByProgramValue, SetStandardProgramByName, SetStandardProgramById, SetStandardProgramByValue
Aliases:

Required: False
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:

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: SetDeviceProgramByName, SetDeviceProgramById, SetDeviceProgramByValue, SetDeviceProgramByProgramValue
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: SetStandardProgramByProgramValue, SetStandardProgramByName, SetStandardProgramById, SetStandardProgramByValue
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: SetStandardProgramByProgramValue, SetStandardProgramByName, SetStandardProgramById, SetStandardProgramByValue
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: SetStandardProgramByProgramValue, SetStandardProgramByName, SetStandardProgramById, SetStandardProgramByValue
Aliases:

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

-EnableTaskSequence

Indica se este programa pode ser instalado a partir do passo da sequência de tarefas "Instalar pacotes".

Type: Boolean
Parameter Sets: SetStandardProgramByProgramValue, SetStandardProgramByName, SetStandardProgramById, SetStandardProgramByValue
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

-GenerateMomAlertOnFail

Indica se o Gestor de Configuração gera uma entrada de evento de registo de aplicação se o programa falhar.

Type: Boolean
Parameter Sets: SetStandardProgramByProgramValue, SetStandardProgramByName, SetStandardProgramById, SetStandardProgramByValue
Aliases:

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

-InputObject

Especifique um objeto de programa para configurar. Para obter este objeto, utilize o cmdlet Get-CMProgram.

Type: IResultObject
Parameter Sets: SetStandardProgramByProgramValue, SetStandardProgramByValue, SetDeviceProgramByValue, SetDeviceProgramByProgramValue
Aliases: ProgramPackage, Package, Program

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

-PackageId

Especifique um ID de pacote com o programa para configurar.

Type: String
Parameter Sets: SetStandardProgramById, SetDeviceProgramById
Aliases: Id

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

-Nome do pacote

Especifique um nome de pacote com o programa para configurar.

Type: String
Parameter Sets: SetStandardProgramByName, SetDeviceProgramByName
Aliases: Name

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

- PassThru

Devolve um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-ProgramAssignedType

Especifique se o programa é executado uma vez no computador, ou uma vez para cada utilizador que se inscreve no computador. O valor predefinido é RunOnceForTheComputer. O programa só é atribuído aos utilizadores quando o parâmetro ProgramRunType está definido para OnlyWhenUserIsLoggedOn .

Type: ProgramAssignedType
Parameter Sets: SetStandardProgramByProgramValue, SetStandardProgramByName, SetStandardProgramById, SetStandardProgramByValue
Aliases:
Accepted values: RunOnceForTheComputer, RunOnceForEveryUserWhoLogsOn

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

- Nome do Programa

Especifique o nome do programa para configurar.

Type: String
Parameter Sets: SetStandardProgramByName, SetStandardProgramById, SetStandardProgramByValue, SetDeviceProgramByName, SetDeviceProgramById, SetDeviceProgramByValue
Aliases: StandardProgramName, DeviceProgramName

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

-ProgramRunType

Especifique as condições de início de saúde necessárias para que o programa seja executado. O valor predefinido é OnlyWhenUserIsLoggedOn.

Type: ProgramRunType
Parameter Sets: SetStandardProgramByProgramValue, SetStandardProgramByName, SetStandardProgramById, SetStandardProgramByValue
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 entra.

Type: Boolean
Parameter Sets: SetStandardProgramByProgramValue, SetStandardProgramByName, SetStandardProgramById, SetStandardProgramByValue
Aliases:

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

-Remover Sistemas de Operações SuportadosPlatform

Especifique uma ou mais plataformas de SO suportadas para remover para o programa. Para obter este objeto, utilize o cmdlet Get-CMSupportedPlatform.

Type: IResultObject[]
Parameter Sets: SetStandardProgramByProgramValue, SetStandardProgramByName, SetStandardProgramById, SetStandardProgramByValue
Aliases: RemoveSupportedOperatingSystemPlatforms

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

-Requisito

Especifique quaisquer requisitos adicionais para programas standard ou dispositivo.

Type: String
Parameter Sets: (All)
Aliases:

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

-RunMode

Especifique as credenciais que o computador cliente necessita para executar o programa.

Type: RunModeType
Parameter Sets: SetStandardProgramByProgramValue, SetStandardProgramByName, SetStandardProgramById, SetStandardProgramByValue
Aliases:
Accepted values: RunWithUserRights, RunWithAdministrativeRights

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

-RunOnAnyPlatform

Adicione este parâmetro para limpar todas as plataformas de OS suportadas deste programa.

Type: SwitchParameter
Parameter Sets: SetStandardProgramByProgramValue, SetStandardProgramByName, SetStandardProgramById, SetStandardProgramByValue
Aliases: ClearSupportedOperatingSystemPlatforms

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: SetStandardProgramByProgramValue, SetStandardProgramByName, SetStandardProgramById, SetStandardProgramByValue
Aliases:
Accepted values: Normal, Minimized, Maximized, Hidden

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

-Programa Standard

Indica que o tipo de programa no pacote de implantação é o programa padrão.

Type: SwitchParameter
Parameter Sets: SetStandardProgramByProgramValue, SetStandardProgramByName, SetStandardProgramById, SetStandardProgramByValue
Aliases:

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

-Suprimir aNotificação

Desa esta definição deste parâmetro $true para suprimir notificações do programa.

Type: Boolean
Parameter Sets: SetStandardProgramByProgramValue, SetStandardProgramByName, SetStandardProgramById, SetStandardProgramByValue
Aliases:

Required: False
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: SetStandardProgramByProgramValue, SetStandardProgramByName, SetStandardProgramById, SetStandardProgramByValue
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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

Sistema.Objeto

NOTAS

Programa DE Desativação CM

Ativar-CMPrograma

Get-CMPrograma

Novo Programa CM

Remover-CMPrograma