New-CMApplicationDeployment

Criar uma implementação de aplicação.

Sintaxe

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 implementação de aplicação. Para obter mais informações, veja Implementar aplicações com o Configuration Manager.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Instalar uma aplicação

Este comando cria uma nova implementação para o Visual Studio 2019 na coleção Developers Workstation. Instala a aplicação e é necessária. Tanto a data como o prazo disponíveis são iguais no passado, pelo que, assim que o cliente receber esta política, instala a aplicação.

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

Utilize este parâmetro para configurar a opção reparar a aplicação ao criar uma implementação para uma aplicação.

Tipo:Boolean
Aliases:AllowUserRepairApplication
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ApprovalRequired

Se definir este parâmetro como $true, um administrador tem de aprovar um pedido para esta aplicação no dispositivo.

Tipo:Boolean
Aliases:AppRequiresApproval
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AutoCloseExecutable

A partir da versão 2107, defina este parâmetro como para $true ativar a definição de implementação de aplicações para comportamentos de instalação. Em seguida, utilize o cmdlet Add-CMDeploymentTypeInstallBehavior para adicionar um ficheiro executável para verificar se a instalação não está em execução.

Defina este parâmetro como para $false desativar esta opção nas seguintes situações:

Tipo:Boolean
Aliases:AutoCloseExeOnInstallBehavior
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AvailableDateTime

Especifique um objeto DateTime para quando esta implementação estiver disponível. Para obter este objeto, utilize o cmdlet incorporado Get-Date .

Utilize DeadlineDateTime para especificar a atribuição de implementação ou o prazo.

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Collection

Especifique um objeto de coleção para o qual a aplicação é implementada. Para obter este objeto, utilize o cmdlet Get-CMCollection .

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CollectionId

Especifique o ID da coleção na qual esta aplicação é implementada. Por exemplo, "SMS00004".

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CollectionName

Especifique o nome da coleção na qual esta aplicação é implementada.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-Comment

Especifique um comentário opcional para esta implementação.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeadlineDateTime

Especifique um objeto DateTime para quando esta implementação é atribuída, também conhecido como prazo limite. Para obter este objeto, utilize o cmdlet incorporado Get-Date .

Utilize -AvailableDateTime para especificar quando a implementação está disponível.

Tipo:DateTime
Aliases:SupersedenceDeadlineDateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeployAction

Especifique a ação de implementação para instalar ou desinstalar a aplicação. Se as implementações concorrentes forem direcionadas para o mesmo dispositivo, a ação Instalar tem prioridade.

Tipo:DeployActionType
Valores aceitos:Install, Uninstall
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeployPurpose

Especifique a finalidade da implementação:

  • Available: o utilizador vê a aplicação no Centro de Software. Podem instalá-lo a pedido.

  • Required: o cliente instala automaticamente a aplicação de acordo com a agenda que definiu. Se a aplicação não estiver oculta, um utilizador pode controlar o respetivo estado de implementação. Também podem utilizar o Centro de Software para instalar a aplicação antes do prazo.

Tipo:DeployPurposeType
Valores aceitos:Available, Required
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableContentDependencyDetection

Adicione este parâmetro para não distribuir automaticamente conteúdo para aplicações dependentes.

Tipo:SwitchParameter
Aliases:DisableDetectAssociatedContentDependencies
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DistributeCollectionName

O site distribui o conteúdo pelos pontos de distribuição associados a este nome de coleção.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DistributeContent

Adicione este parâmetro se precisar de distribuir primeiro o conteúdo da aplicação.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DistributionPointGroupName

Para distribuir o conteúdo da aplicação, especifique o nome de um grupo de pontos de distribuição.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DistributionPointName

Para distribuir o conteúdo da aplicação, especifique o nome de um ponto de distribuição.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableMomAlert

Defina este parâmetro como para $true ativar o modo de manutenção do System Center Operations Manager para esta implementação.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableSoftDeadline

Defina este parâmetro como para $true ativar a imposição atrasada.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-FailParameterValue

Especifica a percentagem de instalação falhada da aplicação que causa um alerta. Especifique um número inteiro de 1 a 100. Para ativar este alerta, defina o parâmetro CreatAlertBaseOnPercentFailure como $True.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-GenerateScomAlertOnFailure

Indica se deve criar um alerta do Operations Manager se um cliente não conseguir instalar a aplicação.

Tipo:Boolean
Aliases:RaiseMomAlertsOnFailure
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifique o ID da aplicação a implementar.

Tipo:Int32
Aliases:CIId, CI_ID, ApplicationId
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifique um objeto de aplicação a implementar. Para obter este objeto, utilize o cmdlet Get-CMApplication .

Tipo:IResultObject
Aliases:Application
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifique o nome da aplicação a implementar.

Tipo:String
Aliases:LocalizedDisplayName, ApplicationName
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OverrideServiceWindow

Indica se a implementação ocorre mesmo que seja agendada fora de uma janela de manutenção. Uma janela de manutenção é um período de tempo especificado utilizado para manutenção e atualizações do computador. Se este valor for $True, o Configuration Manager implementa a aplicação mesmo que a hora agendada fique fora da janela de manutenção. Se este valor for $False, o Configuration Manager não implementa a aplicação fora da janela. Aguarda até poder ser implementado numa janela disponível.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PersistOnWriteFilterDevice

Indica se pretende ativar filtros de escrita para dispositivos incorporados. Para um valor de $True, o dispositivo consolida as alterações durante uma janela de manutenção. Esta ação requer um reinício. Para um valor de $False, o dispositivo guarda as alterações numa sobreposição e consolida-as mais tarde.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PostponeDateTime

Quando definir CreateAlertBaseOnPercentSuccess como $true, utilize este parâmetro para especificar um objeto DateTime . O Configuration Manager cria um alerta de implementação quando o limiar é inferior ao SuccessParameterValue após esta data.

Para obter este objeto, utilize o cmdlet incorporado Get-Date .

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PreDeploy

Indica se deve pré-implementar a aplicação no dispositivo primário do utilizador.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RebootOutsideServiceWindow

Indica se um computador é reiniciado fora de uma janela de manutenção. Uma janela de manutenção é um período de tempo especificado utilizado para manutenção e atualizações do computador. Se este valor for $True, qualquer reinício necessário ocorrerá sem ter em conta as janelas de manutenção. Se este valor for $False, o computador não é reiniciado fora de uma janela de manutenção.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ReplaceToastNotificationWithDialog

Quando o software necessário estiver disponível no cliente, defina este parâmetro para $true substituir as notificações de alerta predefinidas por uma janela de caixa de diálogo. É falso por predefinição. Para obter mais informações, veja Substituir notificações de alertas pela janela da caixa de diálogo.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SendWakeupPacket

Indica se pretende enviar um pacote de reativação para computadores antes do início da implementação. Se este valor for $True, o Configuration Manager tenta reativar um computador do modo de suspensão. Se este valor for $False, não reativa os computadores do modo de suspensão. Para que os computadores reativam, primeiro tem de configurar a Reativação por LAN.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Simulation

Adicione este parâmetro para criar uma simulação de implementação. Para obter mais informações, veja Simulate application deployments with Configuration Manager (Simular implementações de aplicações com o Configuration Manager).

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SuccessParameterValue

Especifica a percentagem de instalação bem-sucedida da aplicação que causa um alerta. Especifique um número inteiro de 0 a 99. Para ativar este alerta, defina o parâmetro CreateAlertBaseOnPercentSuccess como $True.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TimeBaseOn

Especifica o fuso horário a utilizar:

  • LocalTime: utilize a hora local.
  • UTC: Utilize a Hora Universal Coordenada (UTC).
Tipo:TimeType
Valores aceitos:LocalTime, Utc
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UpdateSupersedence

Para uma implementação disponível, utilize este parâmetro para especificar o prazo de instalação para atualizar utilizadores ou dispositivos que tenham a aplicação sobreposta instalada. Utilize DeadlineDateTime para especificar uma hora específica, caso contrário, será o mais rápido possível após o AvailableDateTime.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UseMeteredNetwork

Indica se pretende permitir que os clientes transfiram conteúdo através de uma ligação à Internet com tráfego limitado após o prazo, o que pode incorrer em despesas adicionais.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UserNotification

Especifica o tipo de notificação do utilizador.

  • DisplayAll: apresentar no Centro de Software e mostrar todas as notificações.
  • DisplaySoftwareCenterOnly: apresentar no Centro de Software e mostrar apenas notificações de reinícios do computador.
  • HideAll: oculte-se no Centro de Software e em todas as notificações.
Tipo:UserNotificationType
Valores aceitos:DisplayAll, DisplaySoftwareCenterOnly, HideAll
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object