Set-CMPackage

Modificar um pacote.

Sintaxe

Set-CMPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetry <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-InputObject] <IResultObject>
   [-Language <String>]
   [-Manufacturer <String>]
   [-MifFileName <String>]
   [-MifName <String>]
   [-MifPublisher <String>]
   [-MifVersion <String>]
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priorities>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetry <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   -Id <String>
   [-Language <String>]
   [-Manufacturer <String>]
   [-MifFileName <String>]
   [-MifName <String>]
   [-MifPublisher <String>]
   [-MifVersion <String>]
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priorities>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetry <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-EnableBinaryDeltaReplication <Boolean>]
   [-Language <String>]
   [-Manufacturer <String>]
   [-MifFileName <String>]
   [-MifName <String>]
   [-MifPublisher <String>]
   [-MifVersion <String>]
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-Path <String>]
   [-PersistContentInCache <Boolean>]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priorities>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilize este cmdlet para alterar as definições de um pacote. Para obter mais informações, veja Pacotes e programas no 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: Mudar o nome de um pacote e adicionar uma descrição

Este comando muda o nome do pacote que tem o ID ST120001 para ScriptsPackage02 e adiciona uma descrição.

Set-CMPackage -Id "ST120001" -NewName "ScriptsPackage02" -Description "This package deploys scripts that run on a recurring schedule."

Exemplo 2: Alterar o caminho de origem do pacote

O primeiro comando obtém o pacote que tem o ID ST120001 e armazena os resultados na variável $Pkg . O segundo comando altera o caminho de origem do pacote.

$pkg = Get-CMPackage -Id "ST120001"
Set-CMPackage -InputObject $pkg -Path "\\sources\cmpkg$\newpkg01"

Parâmetros

-Confirm

Adicione este parâmetro para pedir confirmação antes da execução do cmdlet.

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

-CopyToPackageShareOnDistributionPoint

Os clientes podem sempre transferir um pacote a partir de um ponto de distribuição. Se definir este parâmetro como $true, o site disponibiliza-o através de uma partilha de rede nomeada em pontos de distribuição. Utilize CustomPackageShareName para especificar um nome de partilha personalizado.

Quando ativa esta opção, é necessário mais espaço nos pontos de distribuição. Aplica-se a todos os pontos de distribuição aos quais distribui este pacote.

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

-CustomPackageShareName

Se ativar CopyToPackageShareOnDistributionPoint, pode utilizar este parâmetro para personalizar o nome da partilha. O comprimento máximo é de 127 carateres e não pode incluir nenhum dos seguintes carateres: " / [ ] : | < > + = ; , ? *. Pode especificar um nome de partilha e um nome de pasta, mas o máximo para cada um é de 80 carateres. Por exemplo, ShareName\FolderName.

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

-Description

Especifique uma descrição opcional do pacote para o ajudar a identificá-lo. Pode utilizar um máximo de 128 carateres.

Tipo:String
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

-DisconnectUserFromDistributionPoint

Esta opção foi preterida. Define a propriedade ForcedDisconnectEnabled do pacote de controlador.

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

-DisconnectUserFromDistributionPointMins

Esta opção foi preterida. Define a propriedade ForcedDisconnectDelay do pacote de controlador.

Tipo:UInt32
Aliases:ForcedDisconnectDelay, DisconnectUsersFromDistributionPointsMinutes, DisconnectUserFromDistributionPointsMins, DisconnectUserFromDistributionPointsMinutes
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisconnectUserFromDistributionPointRetry

Esta opção foi preterida. Define a propriedade ForcedDisconnectNumRetries do pacote de controlador.

Tipo:UInt32
Aliases:ForceDisconnectNumRetries, DisconnectUsersFromDistributionPointsRetries
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DistributionPointUpdateSchedule

Utilize este parâmetro para atualizar pontos de distribuição com base numa agenda. Para obter um objeto de agendamento, utilize o cmdlet New-CMSchedule .

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

-EnableBinaryDeltaReplication

Defina este parâmetro como $true para ativar a replicação diferencial binária (BDR). Para obter mais informações, veja Conceitos fundamentais para a gestão de conteúdos no Configuration Manager.

Tipo:Boolean
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

-Id

Especifique o ID de um pacote a configurar. Este valor é um ID de pacote padrão, por exemplo: XYZ00020.

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

-InputObject

Especifique um objeto de pacote a configurar. Para obter este objeto, utilize o cmdlet Get-CMPackage .

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

-Language

Especifique uma cadeia de idioma para o pacote. Pode utilizar um máximo de 32 carateres num formato que opte por utilizar para identificar a versão do idioma. Para identificar um pacote, o Configuration Manager utiliza os parâmetros Idioma, Fabricante, Nome e Versão . Por exemplo, pode ter uma versão em inglês e uma versão alemã do mesmo pacote.

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

-Manufacturer

Especifique o nome do fabricante do software. Pode utilizar um máximo de 32 carateres. Para identificar um pacote, o Configuration Manager utiliza os parâmetros Idioma, Fabricante, Nome e Versão .

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

-MifFileName

Especifique o nome do ficheiro MIF (Management Information Format) que contém o estado do pacote. A extensão de nome de ficheiro tem de ser .mif. Utilize um ficheiro MIF de estado para gerar relatórios de estado detalhados. Para gerar um ficheiro MIF de estado, a aplicação tem de chamar a função InstallStatusMIF. Para obter mais informações, veja Status MIF Functions (Funções MIF de Estado).

Se definir este parâmetro, quando o cliente executa a implementação, o cliente do Configuration Manager procura no %TEMP% diretório ou no diretório o %windir% ficheiro MIF de estado de instalação que especificar. O estado da instalação indica se o programa foi executado com êxito.

Se o cliente não encontrar o ficheiro, procura todos os ficheiros MIF nesses diretórios. Faz uma comparação não sensível a maiúsculas e minúsculas dos valores que especificar para MifName, MifPublisher e MifVersion para os valores especificados pelo ficheiro MIF. Se o cliente encontrar uma correspondência, utiliza o estado que o ficheiro MIF especifica como o estado de instalação do programa. Se não conseguir encontrar uma correspondência ou se não especificar MifFileName, o cliente utiliza o código de saída do programa para definir o estado de instalação do programa. Um código de saída de zero indica que o programa foi executado com êxito. Quaisquer outros valores indicam códigos de erro específicos da aplicação.

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

-MifName

Especifique o nome do pacote para correspondência MIF, até 50 carateres. Para obter mais informações, veja o parâmetro MifFileName .

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

-MifPublisher

Especifique o fabricante de software do pacote para correspondência MIF, até 32 carateres. Para obter mais informações, veja o parâmetro MifFileName .

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

-MifVersion

Especifique o número da versão do pacote para correspondência MIF, até 32 carateres. Para obter mais informações, veja o parâmetro MifFileName .

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

-MulticastAllow

Defina este parâmetro como $true para permitir que este pacote seja transferido através de multicast. Para obter mais informações, veja Utilizar multicast para implementar o Windows através da rede com o Configuration Manager.

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

-MulticastEncrypt

Se ativar MulticastAllow, defina este parâmetro como $true para encriptar pacotes multicast.

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

-MulticastTransferOnly

Se ativar MulticastAllow, defina este parâmetro como $true para transferir apenas este pacote de controlador através de multicast.

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

-Name

Especifique um nome de pacote. Pode utilizar um máximo de 250 carateres. Para identificar um pacote, o Configuration Manager utiliza os parâmetros Idioma, Fabricante, Nome e Versão .

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

-NewName

Utilize este parâmetro para mudar o nome de um pacote.

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

-PassThru

Adicione este parâmetro para devolver um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

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

-Path

Se o pacote contiver ficheiros de origem, especifique a localização dos ficheiros. Pode especificar um caminho local completo no servidor do site ou um caminho de rede. Certifique-se de que esta localização contém todos os ficheiros e subdiretórios que o programa precisa de executar, incluindo quaisquer scripts.

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

-PersistContentInCache

Se não quiser que o conteúdo deste pacote fique fora da cache do cliente para libertar espaço para outros conteúdos, defina este parâmetro como $true para o manter na cache do cliente.

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

-PrestageBehavior

Especifique o comportamento quando ativa um ponto de distribuição para conteúdo pré-configurado:

  • ManualCopy: copie manualmente o conteúdo deste pacote para o ponto de distribuição
  • DownloadDelta: transferir apenas alterações de conteúdo para o ponto de distribuição
  • OnDemand: transferir automaticamente conteúdo quando os pacotes são atribuídos a pontos de distribuição

Para obter mais informações, veja Utilizar conteúdo pré-configurado.

Tipo:PrestageBehavior
Valores aceitos:ManualCopy, DownloadDelta, OnDemand
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Priority

Especifique a ordem pela qual o site envia o conteúdo para outros sites e os pontos de distribuição neste site.

O site envia conteúdo de alta prioridade antes de pacotes com prioridade normal ou baixa. Os pacotes com prioridade igual são enviados pela ordem em que são criados.

Tipo:Priorities
Aliases:DistributionPriority
Valores aceitos:High, Normal, Low
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SendToPreferredDistributionPoint

Se quiser ativar a distribuição de conteúdos a pedido para pontos de distribuição preferenciais, defina este parâmetro como $true. Quando ativa esta definição, se um cliente pedir o conteúdo do pacote e o conteúdo não estiver disponível em pontos de distribuição, o ponto de gestão distribui o conteúdo. Para obter mais informações, veja Distribuição de conteúdos a pedido.

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

-Version

Especifique um número de versão para o software. O comprimento máximo desta cadeia é de 32 carateres. Para identificar um pacote, o Configuration Manager utiliza os parâmetros Idioma, Fabricante, Nome e Versão .

Tipo:String
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:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object