New-CMApplicationDeployment
SYNOPSIS
Criar uma implementação de aplicação.
SYNTAX
SearchByValueMandatory (Padrão)
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>]
SearchByIdMandatory
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>]
PesquisaByNameMandatory
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 CmApplicationDeployment cmdlet cria uma implementação de aplicação. Para obter mais informações, consulte implementar aplicações com o Gestor de Configuração.
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: Instalar uma aplicação
Este comando cria uma nova implantação para Visual Studio 2019 para a coleção Developers Workstation. Instala a aplicação e é necessária. Tanto a data e o prazo disponíveis são o mesmo tempo do passado, pelo que assim que o cliente recebe esta apólice, instala a app.
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
PARAMETERS
-AllowRepairApp
Utilize este parâmetro para configurar a opção de aplicação de reparação ao criar uma implementação para uma aplicação.
Type: Boolean
Parameter Sets: (All)
Aliases: AllowUserRepairApplication
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AprovaçãoRequired
Se definir este parâmetro para $true , um administrador deve aprovar um pedido para esta aplicação no dispositivo.
Type: Boolean
Parameter Sets: (All)
Aliases: AppRequiresApproval
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AvailableDateTime
Especifique um objeto DateTime para quando esta implementação estiver disponível. Para obter este objeto, utilize o cmdlet get-date incorporado.
Use o DeadlineDateTime para especificar a atribuição de implantação ou prazo.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Coleção
Especifique um objeto de recolha para o qual a aplicação é implantada. Para obter este objeto, utilize o cmdlet Get-CMCollection.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Especificar o ID da coleção para a qual esta aplicação é implantada. Por exemplo, "SMS00004".
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome de coleção
Especificar o nome da coleção para a qual esta aplicação é implantada.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-Comentário
Especifique um comentário opcional para esta implementação.
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: None
Accept pipeline input: False
Accept wildcard characters: False
- DeadlineDateTime
Especifique um objeto DateTime para quando esta implementação for atribuída, também conhecida como o prazo. Para obter este objeto, utilize o cmdlet get-date incorporado.
Utilizar -AvailableDateTime para especificar quando a implementação está disponível.
Type: DateTime
Parameter Sets: (All)
Aliases: SupersedenceDeadlineDateTime
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ImplementarAcção
Especifique a ação de implantação, quer para instalar ou desinstalar a aplicação. Se as implementações concorrentes direcionarem o mesmo dispositivo, a ação de Instalação tem prioridade.
Type: DeployActionType
Parameter Sets: (All)
Aliases:
Accepted values: Install, Uninstall
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ImplementarPurpose
Especificar a finalidade de implantaçã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 o horário que definiu. Se a aplicação não estiver oculta, um utilizador pode rastrear o seu estado de implantação. Também podem utilizar o Software Center para instalar a aplicação antes do prazo.
Type: DeployPurposeType
Parameter Sets: (All)
Aliases:
Accepted values: Available, Required
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableContentDependencyDetection
Adicione este parâmetro para não distribuir automaticamente conteúdo para aplicações dependentes.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: DisableDetectAssociatedContentDependencies
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
-Distribuir Nome decolecção
O site distribui conteúdo pelos pontos de distribuição associados a este nome de coleção.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistribuirContent
Adicione este parâmetro se precisar de distribuir primeiro o conteúdo da aplicação.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointGroupName
Para distribuir o conteúdo da aplicação, especifique o nome de um grupo de pontos de distribuição.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome do Ponto de Distribuição
Para distribuir o conteúdo da aplicação, especifique o nome de um ponto de distribuição.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableMomAlert
Deslote este parâmetro $true para permitir System Center modo de manutenção do Gestor de Operações para esta implementação.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EnableSoftDeadline
Desa esta definição deste parâmetro $true para permitir a execução tardia.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-FailParameterValue
Especifica a percentagem de instalação de aplicação falhada que causa um alerta.
Especifique um inteiro de 1 a 100.
Para ativar este alerta, desloque o parâmetro CreatAlertBaseOnPercentFailure para $True .
Type: Int32
Parameter Sets: (All)
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
-GeneratescomAlertOnFailure
Indica se deve criar um alerta de Gestor de Operações se um cliente não instalar a aplicação.
Type: Boolean
Parameter Sets: (All)
Aliases: RaiseMomAlertsOnFailure
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- ID
Especifique o ID da aplicação a implementar.
Type: Int32
Parameter Sets: SearchByIdMandatory
Aliases: CIId, CI_ID, ApplicationId
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Especifique um objeto de aplicação para implementar. Para obter este objeto, utilize o cmdlet Get-CMApplication.
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases: Application
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-Name
Especifique o nome da aplicação a implementar.
Type: String
Parameter Sets: SearchByNameMandatory
Aliases: LocalizedDisplayName, ApplicationName
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-OverrideServiceWindow
Indica se a colocação ocorre mesmo que seja programada 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 de computadores.
Se este valor for $True , o Gestor de Configuração implementa a aplicação mesmo que a hora programada caia fora da janela de manutenção.
Se este valor $False for, o Gestor de Configuração não implementa a aplicação fora da janela. Espera até poder implantar numa janela disponível.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PersistOnWriteFilterDevice
Indica se deve ativar filtros de escrita para dispositivos incorporados.
Por um valor de $True , o dispositivo comete alterações durante uma janela de manutenção. Esta ação requer um recomeço.
Por um valor de $False , o dispositivo guarda alterações numa sobreposição e compromete-as mais tarde.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Adiar Hora do Natal
Quando definir CreateAlertBaseOnPercentSuccess para $true , utilize este parâmetro para especificar um objeto DateTime. O Gestor de Configuração cria um alerta de implementação quando o limiar é inferior ao SuccessParameterValue após esta data.
Para obter este objeto, utilize o cmdlet get-date incorporado.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PreDeploy
Indica se deve pré-implantar a aplicação no dispositivo primário do utilizador.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RebootOutsideServiceWindow
Indica se um computador reinicia 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 de computadores.
Se este valor $True for, qualquer reinício necessário ocorre sem ter em conta as janelas de manutenção.
Se este valor $False for, o computador não reinicia fora de uma janela de manutenção.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SubstituirToastNotificationWithDialog
Quando o software necessário estiver disponível no cliente, defina este parâmetro $true para substituir as notificações de torradas predefinidas por uma janela de diálogo. É falso por defeito. Para obter mais informações, consulte substituir as notificações de torradas por janela de diálogo.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SendWakeupPacket
Indica se deve enviar um pacote de despertar para os computadores antes do início da implantação.
Se este valor $True for, o Gestor de Configurações tenta acordar um computador do sono.
Se este valor $False for, não desperta os computadores do sono.
Para que os computadores acordem, primeiro tem de configurar Wake On LAN.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Simulação
Adicione este parâmetro para criar uma simulação de implantação. Para obter mais informações, consulte simular implementações de aplicações com o Gestor de Configuração.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SucessoParameterValue
Especifica a percentagem de instalação de aplicação bem sucedida que causa um alerta.
Especifique um inteiro de 0 a 99.
Para ativar este alerta, desaperte o parâmetro CreateAlertBaseOnPercentSuccess como $True .
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TimeBaseOn
Especifica qual o fuso horário a utilizar:
LocalTime: Use a hora local.UTC: Utilizar o Tempo Universal Coordenado (UTC).
Type: TimeType
Parameter Sets: (All)
Aliases:
Accepted values: LocalTime, Utc
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ActualizaçõesPersedence
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 substituida instalada. Utilize o DeadlineDateTime para especificar uma hora específica, caso contrário será o mais rapidamente possível após o Tempo de Viagem Disponível.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseMeteredNetwork
Indica se permite que os clientes descarreguem conteúdo sobre uma ligação à Internet medido após o prazo, o que pode incorrer em despesas adicionais.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Notificação do Utilizador
Especifica o tipo de notificação do utilizador.
DisplayAll: Exibir no Centro de Software e mostrar todas as notificações.DisplaySoftwareCenterOnly: Display in Software Center e apenas mostrar notificações de reiniciar o computador.HideAll: Ocultar-se no Centro de Software e todas as notificações.
Type: UserNotificationType
Parameter Sets: (All)
Aliases:
Accepted values: DisplayAll, DisplaySoftwareCenterOnly, HideAll
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: None
Accept pipeline input: False
Accept wildcard characters: False
-AutoCloseExecutável
A partir da versão 2107, defina este parâmetro para $true permitir a definição de implementação da aplicação para comportamentos de instalação. Em seguida, utilize o cmdlet Dedtilamento DeploymentTypeInstallBehavior para adicionar um ficheiro executável para verificar se não está a funcionar para que a instalação tenha sucesso.
Desative este parâmetro $false para desativar esta opção nas seguintes situações:
- Quando utilizar o cmdlet Remove-CMDeploymentTypeInstallBehavior para remover todos os ficheiros executáveis
- Não quer que a implantação verifique se há execuções executáveis.
Type: Boolean
Parameter Sets: (All)
Aliases: AutoCloseExeOnInstallBehavior
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.