Modificar um programa de um pacote.
\n","uid":"ConfigurationManager.Set-CMProgram"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.Set-CMProgram":{"href":"set-cmprogram","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"Set-CMProgram","schemaType":"PowershellCmdlet","summary":"Modificar um programa de um pacote.
\n","uid":"ConfigurationManager.Set-CMProgram"}},"description":"Use este cmdlet para modificar um programa de um pacote.\nOs programas identificam as ações que ocorrem quando o cliente recebe o pacote do cliente.\nVocê pode associar vários programas ao mesmo pacote.\nPara obter mais informações, consulte Pacotes e programas no Configuration Manager.
\nObservação
\nExecute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemploPS XYZ:\\>. Para obter mais informações, consulte introdução.
Este exemplo define o requisito do sistema operacional para um programa associado a um pacote padrão. Ele usa o cmdlet Get-CMSupportedPlatform para obter um objeto para a plataforma especificada. Em seguida, ele usa esse objeto de plataforma compatível para configurar o programa.
\n","title":"Exemplo 3: adicionar uma plataforma de sistema operacional compatível"}],"inputs":[{"description":"","name":"Microsoft.ConfigurationManagement.ManagementProvider.IResultObject\n"}],"links":[{"href":"disable-cmprogram","text":"Disable-CMProgram"},{"href":"enable-cmprogram","text":"Enable-CMProgram"},{"href":"get-cmprogram","text":"Get-CMProgram"},{"href":"new-cmprogram","text":"New-CMProgram"},{"href":"remove-cmprogram","text":"Remove-CMProgram"},{"href":"/mem/configmgr/apps/deploy-use/packages-and-programs","text":"Pacotes e programas no Configuration Manager"}],"module":"ConfigurationManager","name":"Set-CMProgram","notes":"","outputs":[{"description":"","name":"System.Object\n"}],"parameters":[{"aliases":"AddSupportedOperatingSystemPlatforms","defaultValue":"None","description":"Especifique uma ou mais plataformas de sistema operacional compatíveis para adicionar ao programa. Para obter esse objeto, use o cmdlet Get-CMSupportedPlatform .
\n","name":"AddSupportedOperatingSystemPlatform","parameterValueGroup":"","position":"Named","type":"IResultObject[]
\n"},{"aliases":"","defaultValue":"None","description":"Especifique a ação que ocorre após o programa ser concluído com êxito.
\n","name":"AfterRunningType","parameterValueGroup":"NoActionRequired, ConfigurationManagerRestartsComputer, ProgramControlsRestart, ConfigurationManagerLogsUserOff","position":"Named","type":"AfterRunningType\n"},{"aliases":"","defaultValue":"None","description":"Especifique a categoria sob a qual o programa é exibido no computador cliente.
\n","name":"Category","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Especifique a linha de comando do programa.
\n","name":"CommandLine","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Especifique a pasta que contém o programa executável. Essa pasta pode ser um caminho absoluto no cliente ou um caminho relativo à pasta de distribuição que contém o pacote.
\n","name":"CommandLineFolder","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Especifique o texto opcional sobre o programa, como uma descrição. Em computadores cliente, esse texto é exibido com o programa no Centro de Software.
\n","name":"Comment","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"cf","defaultValue":"False","description":"Solicita a confirmação antes de executar o cmdlet.
\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Adicione este parâmetro para configurar este programa como um programa de dispositivo.
\n","isRequired":true,"name":"DeviceProgram","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Indica se o computador que executa o programa está no modo de manutenção durante a vigência do programa. Quando no modo de manutenção, o System Center Operations Manager desabilita alertas enquanto o programa é executado.
\n","name":"DisableMomAlertOnRun","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"Defina esse parâmetro como $true para desabilitar temporariamente todas as implantações que contêm esse programa. Você também pode usar o cmdlet Disable-CMProgram .
Esse parâmetro trata caracteres curinga como valores de caracteres literais. Você não pode combiná-lo com ForceWildcardHandling.
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Especifique a quantidade de espaço em disco que o programa de software requer para ser executado no computador. O valor deve ser maior ou igual a zero. Se você especificar um valor, use o parâmetro DiskSpaceUnit para especificar unidades para o valor.
\n","name":"DiskSpaceRequirement","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Especifique uma unidade aceita para o parâmetro DiskSpaceRequirement .
\n","name":"DiskSpaceUnit","parameterValueGroup":"KB, MB, GB","position":"Named","type":"DiskSpaceUnitType\n"},{"aliases":"","defaultValue":"None","description":"Especifique quando o programa deve ser executado.
\n","name":"DownloadProgramType","parameterValueGroup":"AsSoonAsPossible, OnlyOverFastNetwork, OnlyWhenTheDeviceIsDocked","position":"Named","type":"DownloadProgramType\n"},{"aliases":"","defaultValue":"None","description":"Se você usar o parâmetro DriveMode , especifique uma letra de unidade para o local.
\n","name":"DriveLetter","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Indica se o programa requer uma letra de unidade específica, especificada no parâmetro DriveLetter .
\n\n RunWithUnc: Execute o programa pelo caminho UNC. Esse valor é o padrão. A partir da versão 2010, esse valor foi renomeado de RenameWithUnc.
\n RequiresDriveLetter: O programa usa qualquer letra de unidade disponível.
\n RequiresSpecificDriveLetter: o programa só será executado se a unidade ainda não estiver em uso.
Especifica a quantidade máxima de tempo que você espera que o programa seja executado. O valor padrão é 120 minutos.
\n","name":"Duration","parameterValueGroup":"","position":"Named","type":"Int32\n"},{"aliases":"","defaultValue":"None","description":"Indica se esse programa pode ser instalado a partir da etapa de sequência de tarefas Instalar Pacote .
\n","name":"EnableTaskSequence","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Indica se o Configuration Manager gerará uma entrada de evento de log do aplicativo caso o programa falhe.
\n","name":"GenerateMomAlertOnFail","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"ProgramPackage, Package, Program","defaultValue":"None","description":"Especifique um objeto de programa a ser configurado. Para obter esse objeto, use o cmdlet Get-CMProgram .
\n","isRequired":true,"name":"InputObject","parameterValueGroup":"","pipelineInput":true,"position":"Named","type":"IResultObject\n"},{"aliases":"Id","defaultValue":"None","description":"Especifique uma ID de pacote com o programa a ser configurado.
\n","isRequired":true,"name":"PackageId","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"Name","defaultValue":"None","description":"Especifique o nome do pacote com o programa a ser configurado.
\n","isRequired":true,"name":"PackageName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Retorna um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.
\n","name":"PassThru","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Especifique se o programa é executado uma vez no computador ou uma vez para cada usuário que entrar no computador. O valor padrão é RunOnceForTheComputer. O programa só é atribuído a usuários quando o parâmetro ProgramRunType é definido como OnlyWhenUserIsLoggedOn.
Especifique o nome do programa a ser configurado.
\n","isRequired":true,"name":"ProgramName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Especifique as condições de logon necessárias para a execução do programa. O valor padrão é OnlyWhenUserIsLoggedOn.
Indica se o computador cliente se reconecta ao ponto de distribuição quando o usuário entra.
\n","name":"Reconnect","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"RemoveSupportedOperatingSystemPlatforms","defaultValue":"None","description":"Especifique uma ou mais plataformas de sistema operacional com suporte a serem removidas para o programa. Para obter esse objeto, use o cmdlet Get-CMSupportedPlatform .
\n","name":"RemoveSupportedOperatingSystemPlatform","parameterValueGroup":"","position":"Named","type":"IResultObject[]
\n"},{"aliases":"","defaultValue":"None","description":"Especifique quaisquer requisitos adicionais para programas padrão ou de dispositivo.
\n","name":"Requirement","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Especifique as credenciais necessárias para executar o programa no computador cliente.
\n","name":"RunMode","parameterValueGroup":"RunWithUserRights, RunWithAdministrativeRights","position":"Named","type":"RunModeType\n"},{"aliases":"ClearSupportedOperatingSystemPlatforms","defaultValue":"None","description":"Adicione esse parâmetro para limpar todas as plataformas de sistema operacional compatíveis deste programa.
\n","name":"RunOnAnyPlatform","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Especifique o modo de execução do programa no computador cliente. O valor padrão é Normal.
Indica que o tipo de programa no pacote de implantação é programa padrão.
\n","isRequired":true,"name":"StandardProgram","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Defina este parâmetro como $true para suprimir notificações de programa.
Indica se os usuários devem permitir que interajam com o programa.
\n","name":"UserInteraction","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"wi","defaultValue":"False","description":"Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Especifique um diretório de trabalho para o programa.
\n","name":"WorkingDirectory","parameterValueGroup":"","position":"Named","type":"String\n"}],"schema":"PowershellCmdlet","summary":"Modificar um programa de um pacote.
\n","syntaxes":["Set-CMProgram [-AddSupportedOperatingSystemPlatformModificar um programa de um pacote.
\n","uid":"ConfigurationManager.Set-CMProgram"}],"canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/set-cmprogram?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/set-cmprogram?view=sccm-ps"},"pageMetadata":"Use este cmdlet para modificar um programa de um pacote.\nOs programas identificam as ações que ocorrem quando o cliente recebe o pacote do cliente.\nVocê pode associar vários programas ao mesmo pacote.\nPara obter mais informações, consulte Pacotes e programas no Configuration Manager.\nObservação
\nExecute cmdlets do Configuration Manager na unidade do site do Configuration Manager, por exemploPS XYZ:\\>. Para obter mais informações, consulte introdução.