New-CMProgram
Crie um novo programa para um pacote.
Syntax
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>]
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>]
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>]
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
Use este cmdlet para criar um programa para um pacote. Os programas são comandos associados a um pacote Configuration Manager. Eles identificam as ações que ocorrem quando o cliente recebe o pacote cliente. Você pode associar vários programas ao mesmo pacote. Para obter mais informações, consulte Pacotes e programas em Configuration Manager.
Observação
Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>
. Para obter mais informações, confira introdução.
Exemplos
Exemplo 1: Criar um programa
Este exemplo primeiro coloca os parâmetros de cmdlet na variável de parâmetros . Não é necessário emendar os parâmetros, apenas facilita a leitura dos parâmetros para uma linha de comando tão longa.
Esse comando cria um programa chamado Scan x64 no pacote padrão da Ferramenta de Migração de Estado do Usuário para Windows .
$parameters = @{
PackageName = "User State Migration Tool for Windows"
StandardProgramName = "Scan x64"
CommandLine = "amd64\scanstate.exe \\gold\sources$\userdata /i:miguser.xml /i:migapp.xml /o"
RunType = "Normal"
ProgramRunType = "OnlyWhenNoUserIsLoggedOn"
DiskSpaceRequirement = 200
DiskSpaceUnit = "MB"
Duration = 100
DriveMode = "RunWithUnc"
}
New-CMProgram @parameters
Parâmetros
-AddSupportedOperatingSystemPlatform
Especifique uma ou mais plataformas de sistema operacional com suporte para adicionar para o programa. Para obter esse objeto, use o cmdlet Get-CMSupportedPlatform .
Type: | IResultObject[] |
Aliases: | AddSupportedOperatingSystemPlatforms |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CommandLine
Especifique a linha de comando do programa.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CommandLineFolder
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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Comment
Especifique um texto opcional sobre o programa, como uma descrição. Em computadores cliente, este texto é exibido com o programa no Centro de Software.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeviceProgramName
Especifica um nome do programa de dispositivo.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DiskSpaceRequirement
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.
Type: | String |
Aliases: | DiskSpaceReq |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DiskSpaceUnit
Especifique uma unidade aceita para o parâmetro DiskSpaceRequirement .
Type: | DiskSpaceUnitType |
Accepted values: | KB, MB, GB |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DownloadProgramType
Especifique quando o programa deve ser executado.
Type: | DownloadProgramType |
Accepted values: | AsSoonAsPossible, OnlyOverFastNetwork, OnlyWhenTheDeviceIsDocked |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DriveLetter
Se você usar o parâmetro DriveMode , especifique uma letra de unidade para o local.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
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
: execute o programa no caminho UNC. Esse valor é o padrão. A partir da versão 2010, esse valor foi renomeado deRenameWithUnc
.RequiresDriveLetter
: o programa usa qualquer letra de unidade disponível.RequiresSpecificDriveLetter
: o programa só será executado se a unidade ainda não estiver em uso.
Type: | DriveModeType |
Accepted values: | RunWithUnc, RequiresDriveLetter, RequiresSpecificDriveLetter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Duration
Especifica o tempo máximo que você espera que o programa seja executado. O valor padrão é 120 minutos.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PackageId
Especifique a ID do pacote para este programa.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PackageName
Especifique um nome de pacote para este programa.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProgramRunType
Especifica as condições de logon necessárias para que o programa seja executado.
A configuração padrão é OnlyWhenUserIsLoggedOn
.
Type: | ProgramRunType |
Accepted values: | OnlyWhenUserIsLoggedOn, WhetherOrNotUserIsLoggedOn, OnlyWhenNoUserIsLoggedOn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Reconnect
Indica se o computador cliente se reconecta ao ponto de distribuição quando o usuário entra no Windows.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Requirement
Especifica requisitos adicionais para programas padrão ou de dispositivo.
Type: | String |
Aliases: | Requirements |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunMode
Especifique as credenciais necessárias para que o programa seja executado no computador cliente.
Type: | RunModeType |
Accepted values: | RunWithUserRights, RunWithAdministrativeRights |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunType
Especifique o modo em que o programa é executado no computador cliente.
O valor padrão é Normal
.
Type: | RunType |
Accepted values: | Normal, Minimized, Maximized, Hidden |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StandardProgramName
Especifique o nome do programa padrão.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserInteraction
Indica se os usuários devem interagir com o programa.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WorkingDirectory
Especifique um diretório de trabalho para o programa.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
Saídas
IResultObject
Observações
Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_Program classe WMI do servidor.
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de