Set-CMProgram
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 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: 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.