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:
- Quando utiliza o cmdlet Remove-CMDeploymentTypeInstallBehavior para remover todos os ficheiros executáveis
- Não quer que a implementação verifique se existem executáveis em execução.
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