Implementar um pacote legado numa coleção.
\n","uid":"ConfigurationManager.New-CMPackageDeployment"}],"ocv-translation-feedback":true},"_xrefmap":{"ConfigurationManager":{"href":"./","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"ConfigurationManager","schemaType":"PowershellModule","uid":"ConfigurationManager"},"ConfigurationManager.New-CMPackageDeployment":{"href":"new-cmpackagedeployment","monikerGroup":"f98fea35b6ac2b0f56c6ee5ec06ffce9","name":"New-CMPackageDeployment","schemaType":"PowershellCmdlet","summary":"Implementar um pacote legado numa coleção.
\n","uid":"ConfigurationManager.New-CMPackageDeployment"}},"description":"Utilize este cmdlet para implementar um pacote em recursos numa coleção.\nPode especificar a coleção por ID, nome ou transmitir um objeto.
\nPara outras definições de implementação que não pode configurar com este cmdlet, utilize Set-CMPackageDeployment.
\nPara obter mais informações, veja Pacotes e programas no Configuration Manager.
\nObservação
\nExecute 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.
Este comando cria uma implementação do pacote com o ID XYZ00001 para a coleção com o ID XYZ0003F.
\n","title":"Exemplo 1: Implementar um pacote por ID"},{"code":"[datetime]$DeadlineTime = (Get-Date -Hour 20 -Minute 0 -Second 0).AddDays(10)\n\n$NewScheduleDeadline = New-CMSchedule -Start $DeadlineTime -Nonrecurring\n\n$pkgId = \"XYZ00001\"\n$progName = \"Run\"\n$collId = \"XYZ0003F\"\n\nNew-CMPackageDeployment -StandardProgram -PackageId $pkgId -ProgramName $progName -DeployPurpose Required -CollectionId $collId -FastNetworkOption DownloadContentFromDistributionPointAndRunLocally -SlowNetworkOption DownloadContentFromDistributionPointAndLocally -RerunBehavior RerunIfFailedPreviousAttempt -Schedule $NewScheduleDeadline","description":"","summary":"O primeiro comando define uma variável para um prazo para 10 dias a partir de agora às 20:00.\nO segundo comando cria um objeto de agenda com base nesse prazo que se repete diariamente.\nO terceiro comando cria a implementação do pacote com essa agenda.
\n","title":"Exemplo 2: Implementar um pacote conforme necessário com um prazo"}],"inputs":[{"description":"","name":"Microsoft.ConfigurationManagement.ManagementProvider.IResultObject\n"}],"links":[{"href":"get-cmpackagedeployment","text":"Get-CMPackageDeployment"},{"href":"get-cmpackagedeploymentstatus","text":"Get-CMPackageDeploymentStatus"},{"href":"set-cmpackagedeployment","text":"Set-CMPackageDeployment"},{"href":"remove-cmpackagedeployment","text":"Remove-CMPackageDeployment"},{"href":"get-cmpackage","text":"Get-CMPackage"},{"href":"/mem/configmgr/apps/deploy-use/packages-and-programs#deploy-packages-and-programs","text":"Pacotes e programas no Configuration Manager"}],"module":"ConfigurationManager","name":"New-CMPackageDeployment","notes":"","outputs":[{"description":"","name":"System.Object\n"}],"parameters":[{"aliases":"","defaultValue":"None","description":"Permitir que os clientes utilizem pontos de distribuição do grupo de limites do site predefinido.
\n","name":"AllowFallback","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"Permitir que os clientes utilizem pontos de distribuição de um grupo de limites vizinho.
\n","name":"AllowSharedContent","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"Especifique quando esta implementação está disponível.
\nUtilize -DeadlineDateTime para especificar quando a implementação expira e -Schedule para especificar a atribuição de implementação ou o prazo.
\nPara obter um objeto DateTime , utilize o cmdlet Get-Date .
\n","name":"AvailableDateTime","parameterValueGroup":"","position":"Named","type":"DateTime\n"},{"aliases":"","defaultValue":"None","description":"Especifique um objeto de coleção como destino para esta implementação de pacote. Para obter este objeto, utilize o cmdlet Get-CMCollection .
\n","name":"Collection","parameterValueGroup":"","position":"Named","type":"IResultObject\n"},{"aliases":"","defaultValue":"None","description":"Especifique um ID de coleção como destino para esta implementação de pacote.
\n","name":"CollectionId","parameterValueGroup":"","position":"Named","type":"String\n"},{"acceptWildcardCharacters":true,"aliases":"","defaultValue":"None","description":"Especifique um nome de coleção como destino para esta implementação de pacote.
\n","name":"CollectionName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Especifique um comentário opcional para esta implementação de pacote.
\n","name":"Comment","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"cf","defaultValue":"None","description":"Adicione este parâmetro para pedir confirmação antes de executar o cmdlet.
\n","name":"Confirm","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Utilize este parâmetro para especificar quando a implementação expira.
\nUtilize -AvailableDateTime para especificar quando a implementação está disponível e -Schedule para especificar a atribuição de implementação ou o prazo.
\nPara obter um objeto DateTime , utilize o cmdlet Get-Date .
\n","name":"DeadlineDateTime","parameterValueGroup":"","position":"Named","type":"DateTime\n"},{"aliases":"","defaultValue":"None","description":"Especifique se esta implementação está disponível para instalação por parte dos utilizadores ou se é necessário instalar no prazo.
\n","name":"DeployPurpose","parameterValueGroup":"Available, Required","position":"Named","type":"DeployPurposeType\n"},{"aliases":"","defaultValue":"None","description":"Se o programa do pacote que está a implementar for um programa do tipo dispositivo, especifique este parâmetro.
\nCaso contrário, utilize o parâmetro StandardProgram . O tipo de programa padrão destina-se a computadores com o cliente do Configuration Manager.
\n","isRequired":true,"name":"DeviceProgram","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.
\n","name":"DisableWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"O site distribui conteúdo para os grupos de pontos de distribuição associados a este nome de coleção.
\n","name":"DistributeCollectionName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Adicione este parâmetro para distribuir o conteúdo do pacote quando criar esta implementação. Os clientes não podem instalar o pacote até distribuir conteúdo por pontos de distribuição aos quais os clientes podem aceder.
\n","name":"DistributeContent","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"O site distribui conteúdo para este grupo de pontos de distribuição.
\n","name":"DistributionPointGroupName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"O site distribui conteúdo para este ponto de distribuição.
\n","name":"DistributionPointName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Especifique o comportamento quando o cliente utiliza um ponto de distribuição do grupo de limites atual:
\nSe não especificar este parâmetro, este é utilizado por predefinição DownloadContentFromDistributionPointAndRunLocally . Esta opção é mais segura porque o cliente valida o hash de conteúdo antes de executar o programa.
Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.
\n","name":"ForceWildcardHandling","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Especifique um objeto de pacote com o programa a implementar. Para obter este objeto, utilize o cmdlet Get-CMPackage .
\n","isRequired":true,"name":"Package","parameterValueGroup":"","pipelineInput":true,"position":"0","type":"IResultObject\n"},{"aliases":"","defaultValue":"None","description":"Especifique o ID do pacote com o programa a implementar. Este ID é um ID de pacote padrão, por exemplo XYZ007E3.
Especifique o nome do pacote com o programa a implementar.
\n","isRequired":true,"name":"PackageName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Configure a forma como o cliente processa o filtro de escrita em dispositivos Windows Embedded.
\n$true: consolidar alterações no prazo ou durante uma janela de manutenção. É necessário reiniciar.$false: aplique conteúdo sobreposto e consolide mais tarde.Especifique um objeto de programa a implementar. Para obter este objeto, utilize o cmdlet Get-CMProgram .
\n","isRequired":true,"name":"Program","parameterValueGroup":"","pipelineInput":true,"position":"0","type":"IResultObject\n"},{"aliases":"StandardProgramName, DeviceProgramName","defaultValue":"None","description":"Especifique o nome do programa no pacote a implementar.
\n","isRequired":true,"name":"ProgramName","parameterValueGroup":"","position":"Named","type":"String\n"},{"aliases":"","defaultValue":"None","description":"Especifique uma unidade para uma implementação periódica. Utilize o parâmetro RecurValue para especificar o valor para esta unidade.
\n","name":"RecurUnit","parameterValueGroup":"Minutes, Hours, Days","position":"Named","type":"RecurUnitType\n"},{"aliases":"","defaultValue":"None","description":"Especifique a frequência com que a implementação se repete.
\nEste parâmetro depende do tipo de unidade especificado no parâmetro RecurUnit :
\n1 e 231 e 311 e 59Indique se a implementação é executada novamente:
\n$True: a implementação é executada novamente para os clientes, conforme especificado no parâmetro RerunBehavior . Este valor é a predefinição.$False: a implementação não é executada novamente.Especifique se o programa é novamente executado num computador.
\nNeverRerunDeployedProgram: não é executada novamente, mesmo que a implementação tenha falhado ou os ficheiros sejam alterados.AlwaysRerunProgram: execute novamente como agendado, mesmo que a implementação tenha sido bem-sucedida. Pode utilizar este valor para implementações periódicas. Este valor é a predefinição.RerunIfFailedPreviousAttempt: execute novamente como agendado, se a implementação tiver falhado na tentativa anterior.RerunIfSucceededOnPreviousAttempt: execute novamente apenas se a tentativa anterior tiver sido efetuada com êxito.Permitir que os utilizadores executem o programa independentemente das atribuições.
\n","name":"RunFromSoftwareCenter","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"Utilize este parâmetro para especificar a atribuição de implementação ou o prazo.
\nUtilize -AvailableDateTime para especificar quando a implementação está disponível e -DeadlineDateTime para especificar quando a implementação expira.
\nEspecifique uma matriz de objetos de agendamento. Um objeto de agendamento define a agenda de atribuição obrigatória para uma implementação. Para criar um objeto de agendamento, utilize o cmdlet New-CMSchedule .
\n","name":"Schedule","parameterValueGroup":"","position":"Named","type":"IResultObject[]
\n"},{"aliases":"","defaultValue":"None","description":"Especifique o tipo de evento que determina quando a implementação do pacote é executada.
\n","name":"ScheduleEvent","parameterValueGroup":"AsSoonAsPossible, LogOn, LogOff","position":"Named","type":"ScheduleEventType\n"},{"aliases":"","defaultValue":"None","description":"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 reativa 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, configure primeiro a Reativação por LAN.
Especifique o comportamento quando o cliente utiliza um ponto de distribuição de um grupo de limites de vizinhos ou do grupo de limites do site predefinido:
\nSe não especificar este parâmetro, este é utilizado por predefinição DoNotRunProgram .
Quando o prazo de instalação for atingido, defina este parâmetro para $true permitir que o pacote seja instalado fora da janela de manutenção.
Utilize este parâmetro para tipos de programas padrão. Este tipo destina-se a computadores com o cliente do Configuration Manager.
\nSe o programa do pacote que está a implementar for um programa do tipo dispositivo, utilize o parâmetro DeviceProgram .
\n","isRequired":true,"name":"StandardProgram","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"},{"aliases":"","defaultValue":"None","description":"Quando o prazo de instalação for atingido, defina este parâmetro para $true permitir o reinício do sistema, se necessário fora da janela de manutenção.
Indica se pretende permitir que os clientes numa ligação à Internet com tráfego limitado transfiram conteúdo após o prazo de instalação, o que pode incorrer em mais custos.
\n","name":"UseMeteredNetwork","parameterValueGroup":"","position":"Named","type":"Boolean\n"},{"aliases":"","defaultValue":"None","description":"Indica se os clientes utilizam a Hora Universal Coordenada (UTC) para determinar a disponibilidade de um programa. A hora UTC disponibiliza a implementação ao mesmo tempo para todos os computadores. Se não especificar este parâmetro ou o definir como $false, o cliente utiliza a hora local.
Indica se os clientes utilizam a Hora Universal Coordenada (UTC) para determinar a disponibilidade de um programa. A hora UTC disponibiliza a implementação ao mesmo tempo para todos os computadores. Se não especificar este parâmetro ou o definir como $false, o cliente utiliza a hora local.
Indica se os clientes utilizam a Hora Universal Coordenada (UTC) para determinar quando um programa expirou. A hora UTC expira a implementação ao mesmo tempo para todos os computadores. Se não especificar este parâmetro ou o definir como $false, o cliente utiliza a hora local.
Mostrar o que aconteceria se o cmdlet fosse executado.\nO cmdlet não é executado.
\n","name":"WhatIf","parameterValueGroup":"","position":"Named","type":"SwitchParameter\n"}],"schema":"PowershellCmdlet","summary":"Implementar um pacote legado numa coleção.
\n","syntaxes":["New-CMPackageDeployment [-AllowFallbackImplementar um pacote legado numa coleção.
\n","uid":"ConfigurationManager.New-CMPackageDeployment"}],"canonical_url":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmpackagedeployment?view=sccm-ps","_op_canonicalUrl":"https://learn.microsoft.com/pt-br/powershell/module/configurationmanager/new-cmpackagedeployment?view=sccm-ps"},"pageMetadata":"Utilize este cmdlet para implementar um pacote em recursos numa coleção.\nPode especificar a coleção por ID, nome ou transmitir um objeto.\nPara outras definições de implementação que não pode configurar com este cmdlet, utilize Set-CMPackageDeployment.
\nPara obter mais informações, veja Pacotes e programas no Configuration Manager.
\nObservação
\nExecute 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.