New-CMApplicationDeployment
Criar uma implantação de aplicativo.
Syntax
New-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
[-ApprovalRequired <Boolean>]
[-AutoCloseExecutable <Boolean>]
[-DeadlineDateTime <DateTime>]
[-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>]
[-DisableContentDependencyDetection]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
[-GenerateScomAlertOnFailure <Boolean>]
[-InputObject] <IResultObject>
[-OverrideServiceWindow <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-Simulation]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UpdateSupersedence <Boolean>]
[-UserNotification <UserNotificationType>]
[-DistributeCollectionName <String>]
[-DistributeContent]
[-DistributionPointGroupName <String>]
[-DistributionPointName <String>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-PersistOnWriteFilterDevice <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
[-ApprovalRequired <Boolean>]
[-AutoCloseExecutable <Boolean>]
[-DeadlineDateTime <DateTime>]
[-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>]
[-DisableContentDependencyDetection]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
[-GenerateScomAlertOnFailure <Boolean>]
[-Id] <Int32>
[-OverrideServiceWindow <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-Simulation]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UpdateSupersedence <Boolean>]
[-UserNotification <UserNotificationType>]
[-DistributeCollectionName <String>]
[-DistributeContent]
[-DistributionPointGroupName <String>]
[-DistributionPointName <String>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-PersistOnWriteFilterDevice <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMApplicationDeployment
[-AllowRepairApp <Boolean>]
[-ApprovalRequired <Boolean>]
[-AutoCloseExecutable <Boolean>]
[-DeadlineDateTime <DateTime>]
[-DeployAction <DeployActionType>]
[-DeployPurpose <DeployPurposeType>]
[-DisableContentDependencyDetection]
[-EnableMomAlert <Boolean>]
[-EnableSoftDeadline <Boolean>]
[-FailParameterValue <Int32>]
[-GenerateScomAlertOnFailure <Boolean>]
[-Name] <String>
[-OverrideServiceWindow <Boolean>]
[-PostponeDateTime <DateTime>]
[-PreDeploy <Boolean>]
[-RebootOutsideServiceWindow <Boolean>]
[-ReplaceToastNotificationWithDialog <Boolean>]
[-Simulation]
[-SuccessParameterValue <Int32>]
[-TimeBaseOn <TimeType>]
[-UpdateSupersedence <Boolean>]
[-UserNotification <UserNotificationType>]
[-DistributeCollectionName <String>]
[-DistributeContent]
[-DistributionPointGroupName <String>]
[-DistributionPointName <String>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-PersistOnWriteFilterDevice <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet New-CMApplicationDeployment cria uma implantação de aplicativo. Para obter mais informações, consulte Deploy applications with Configuration Manager.
Observação
Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\>
exemplo. Para obter mais informações, consulte getting started.
Exemplos
Exemplo 1: Instalar um aplicativo
Este comando cria uma nova implantação para Visual Studio 2019 para a coleção Developers Workstation. Ele instala o aplicativo e é necessário. A data e o prazo disponíveis são o mesmo tempo no passado, portanto, assim que o cliente recebe essa política, ele instala o aplicativo.
New-CMApplicationDeployment -Name "Visual Studio 2019" -AvailableDateTime '01/01/2020 00:00:00' -CollectionName 'Developers Workstation' -DeadlineDateTime '01/01/2020 00:00:00' -DeployAction Install -DeployPurpose Required
Parâmetros
-AllowRepairApp
Use esse parâmetro para configurar a opção de aplicativo de reparo ao criar uma implantação para um aplicativo.
Type: | Boolean |
Aliases: | AllowUserRepairApplication |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ApprovalRequired
Se você definir esse parâmetro como $true
, um administrador deverá aprovar uma solicitação para esse aplicativo no dispositivo.
Type: | Boolean |
Aliases: | AppRequiresApproval |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoCloseExecutable
A partir da versão 2107, de definir esse parâmetro para habilitar a configuração de implantação do aplicativo $true
para comportamentos de instalação. Em seguida, use o cmdlet Add-CMDeploymentTypeInstallBehavior para adicionar um arquivo executável para verificar se não está sendo executado para que a instalação seja bem-sucedida.
De definir esse parâmetro $false
para desabilitar essa opção nas seguintes situações:
- Quando você usa o cmdlet Remove-CMDeploymentTypeInstallBehavior para remover todos os arquivos executáveis
- Você não deseja que a implantação verifique se há executáveis em execução.
Type: | Boolean |
Aliases: | AutoCloseExeOnInstallBehavior |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AvailableDateTime
Especifique um objeto DateTime para quando essa implantação estiver disponível. Para obter esse objeto, use o cmdlet get-Date integrado.
Use DeadlineDateTime para especificar a atribuição de implantação ou o prazo.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
Especifique um objeto de coleção para o qual o aplicativo é implantado. Para obter esse objeto, use o cmdlet Get-CMCollection.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
Especifique a ID da coleção à qual este aplicativo é implantado. Por exemplo, "SMS00004"
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Especifique o nome da coleção à qual este aplicativo é implantado.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Comentário
Especifique um comentário opcional para essa implantação.
Type: | String |
Position: | Named |
Default value: | None |
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: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeadlineDateTime
Especifique um objeto DateTime para quando essa implantação for atribuída, também conhecido como o prazo. Para obter esse objeto, use o cmdlet get-Date integrado.
Use -AvailableDateTime para especificar quando a implantação está disponível.
Type: | DateTime |
Aliases: | SupersedenceDeadlineDateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeployAction
Especifique a ação de implantação, para instalar ou desinstalar o aplicativo. Se as implantações concorrentes direcionarem para o mesmo dispositivo, a ação Instalar tem prioridade.
Type: | DeployActionType |
Accepted values: | Install, Uninstall |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeployPurpose
Especifique a finalidade de implantação:
Available
: O usuário vê o aplicativo no Centro de Software. Eles podem instalá-lo sob demanda.Required
: O cliente instala automaticamente o aplicativo de acordo com o cronograma definido. Se o aplicativo não estiver oculto, um usuário poderá acompanhar seu status de implantação. Eles também podem usar o Centro de Software para instalar o aplicativo antes do prazo final.
Type: | DeployPurposeType |
Accepted values: | Available, Required |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableContentDependencyDetection
Adicione esse parâmetro para não distribuir automaticamente conteúdo para aplicativos dependentes.
Type: | SwitchParameter |
Aliases: | DisableDetectAssociatedContentDependencies |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributeCollectionName
O site distribui conteúdo para os pontos de distribuição associados a esse nome de coleção.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributeContent
Adicione esse parâmetro se precisar distribuir primeiro o conteúdo do aplicativo.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributionPointGroupName
Para distribuir o conteúdo do aplicativo, especifique o nome de um grupo de pontos de distribuição.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DistributionPointName
Para distribuir o conteúdo do aplicativo, especifique o nome de um ponto de distribuição.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableMomAlert
De definir esse parâmetro para habilitar System Center modo de manutenção $true
do Operations Manager para essa implantação.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableSoftDeadline
De definir esse parâmetro para $true
habilitar a imposição atrasada.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FailParameterValue
Especifica a porcentagem de falha na instalação do aplicativo que causa um alerta.
Especifique um inteiro de 1 a 100.
Para habilitar esse alerta, de definir o parâmetro CreatAlertBaseOnPercentFailure como $True
.
Type: | Int32 |
Position: | Named |
Default value: | None |
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). Não é possível combiná-lo com DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GenerateScomAlertOnFailure
Indica se será criado um alerta do Operations Manager se um cliente não instalar o aplicativo.
Type: | Boolean |
Aliases: | RaiseMomAlertsOnFailure |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Especifique a ID do aplicativo a ser implantado.
Type: | Int32 |
Aliases: | CIId, CI_ID, ApplicationId |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Especifique um objeto de aplicativo a ser implantado. Para obter esse objeto, use o cmdlet Get-CMApplication.
Type: | IResultObject |
Aliases: | Application |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Especifique o nome do aplicativo a ser implantado.
Type: | String |
Aliases: | LocalizedDisplayName, ApplicationName |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OverrideServiceWindow
Indica se a implantação ocorre mesmo que agendada fora de uma janela de manutenção.
Uma janela de manutenção é um período especificado de tempo usado para manutenção e atualizações do computador.
Se esse valor for , o Configuration Manager implantará o aplicativo mesmo que o horário agendado $True
caia fora da janela de manutenção.
Se esse valor for $False
, o Configuration Manager não implantará o aplicativo fora da janela. Ele aguarda até poder implantar em uma janela disponível.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PersistOnWriteFilterDevice
Indica se é possível habilitar filtros de gravação para dispositivos incorporados.
Para um valor de $True
, o dispositivo confirma alterações durante uma janela de manutenção. Essa ação requer uma reinicialização.
Para um valor $False
de , o dispositivo salva alterações em uma sobreposição e as confirma mais tarde.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PostponeDateTime
Quando você definir CreateAlertBaseOnPercentSuccess como , use este $true
parâmetro para especificar um objeto DateTime. O Configuration Manager cria um alerta de implantação quando o limite é menor que SuccessParameterValue após essa data.
Para obter esse objeto, use o cmdlet get-Date integrado.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PreDeploy
Indica se o aplicativo deve ser pré-implantado no dispositivo principal do usuário.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RebootOutsideServiceWindow
Indica se um computador é reiniciado fora de uma janela de manutenção.
Uma janela de manutenção é um período especificado de tempo usado para manutenção e atualizações do computador.
Se esse valor for $True
, qualquer reinicialização necessária ocorrerá sem levar em consideração as janelas de manutenção.
Se esse valor for $False
, o computador não reiniciará fora de uma janela de manutenção.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReplaceToastNotificationWithDialog
Quando o software necessário estiver disponível no cliente, de definir esse parâmetro para substituir as notificações padrão do sistema $true
por uma janela de diálogo. Por padrão, é false. Para obter mais informações, consulte Replace toast notifications with dialog window.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SendWakeupPacket
Indica se um pacote de alerta deve ser enviado para computadores antes do início da implantação.
Se esse valor for $True
, o Configuration Manager tentará acordar um computador do sono.
Se esse valor for $False
, ele não acordará computadores do sono.
Para que os computadores acordem, você deve primeiro configurar Wake On LAN.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Simulation
Adicione esse parâmetro para criar uma simulação de implantação. Para obter mais informações, consulte Simular implantações de aplicativos com o Configuration Manager.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SuccessParameterValue
Especifica a porcentagem de instalação bem-sucedida do aplicativo que causa um alerta.
Especifique um inteiro de 0 a 99.
Para habilitar esse alerta, de definir o parâmetro CreateAlertBaseOnPercentSuccess como $True
.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TimeBaseOn
Especifica qual fuso horário usar:
LocalTime
: Use a hora local.UTC
: Use UTC (Tempo Universal Coordenado).
Type: | TimeType |
Accepted values: | LocalTime, Utc |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpdateSupersedence
Para uma implantação disponível, use esse parâmetro para especificar o prazo de instalação para atualizar usuários ou dispositivos que tenham o aplicativo supersedido instalado. Use DeadlineDateTime para especificar uma hora específica, caso contrário, será assim que possível após a AvailableDateTime.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseMeteredNetwork
Indica se os clientes podem baixar conteúdo por meio de uma conexão de Internet com um limite após o prazo, o que pode incorrer em despesas extras.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UserNotification
Especifica o tipo de notificação do usuário.
DisplayAll
: Exibir no Centro de Software e mostrar todas as notificações.DisplaySoftwareCenterOnly
: Exibe no Centro de Software e mostra apenas notificações de reinicializações do computador.HideAll
: Ocultar no Centro de Software e todas as notificações.
Type: | UserNotificationType |
Accepted values: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
Position: | Named |
Default value: | None |
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: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
System.Object