Set-CMPackage

Módulo:

ConfigurationManager

Modificar um pacote.

Syntax

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

Use este cmdlet para alterar as configurações de um pacote. Para obter mais informações, consulte Pacotes e programas no Configuration Manager.

Observação

Execute cmdlets do Configuration Manager na unidade de site do Configuration Manager, por PS XYZ:\> exemplo. Para obter mais informações, consulte getting started.

Exemplos

Exemplo 1: Renomear um pacote e adicionar uma descrição

Este comando renomeia o pacote que tem a 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 a ID ST120001e 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 esse parâmetro para solicitar confirmação antes que o cmdlet seja executado.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CopyToPackageShareOnDistributionPoint

Os clientes sempre podem baixar um pacote de um ponto de distribuição. Se você definir esse parâmetro como $true, o site o disponibiliza por meio de um compartilhamento de rede nomeado em pontos de distribuição. Use CustomPackageShareName para especificar um nome de compartilhamento personalizado.

Quando você habilita essa opção, mais espaço é necessário nos pontos de distribuição. Ela se aplica a todos os pontos de distribuição aos quais você distribui este pacote.

Type:	Boolean
Aliases:	ShareContent, CopyToPackageShareOnDistributionPoints
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CustomPackageShareName

Se você habilitar CopyToPackageShareOnDistributionPoint, poderá usar esse parâmetro para personalizar o nome do compartilhamento. O comprimento máximo é de 127 caracteres e não pode incluir nenhum dos seguintes caracteres: " / [ ] : | < > + = ; , ? * . Você pode especificar um nome de compartilhamento e um nome de pasta, mas, em seguida, o máximo para cada um é 80 caracteres. Por exemplo, ShareName\FolderName.

Type:	String
Aliases:	ShareName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Especifique uma descrição opcional do pacote para ajudá-lo a identificá-lo. Você pode usar no máximo 128 caracteres.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisconnectUserFromDistributionPoint

Essa opção foi preterida. Ele define a propriedade ForcedDisconnectEnabled do pacote de driver.

Type:	Boolean
Aliases:	ForceDisconnectEnabled, DisconnectUsersFromDistributionPoints
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisconnectUserFromDistributionPointMins

Essa opção foi preterida. Ele define a propriedade ForcedDisconnectDelay do pacote de driver.

Type:	UInt32
Aliases:	ForcedDisconnectDelay, DisconnectUsersFromDistributionPointsMinutes, DisconnectUserFromDistributionPointsMins, DisconnectUserFromDistributionPointsMinutes
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisconnectUserFromDistributionPointRetry

Essa opção foi preterida. Ele define a propriedade ForcedDisconnectNumRetries do pacote de driver.

Type:	UInt32
Aliases:	ForceDisconnectNumRetries, DisconnectUsersFromDistributionPointsRetries
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DistributionPointUpdateSchedule

Use esse parâmetro para atualizar pontos de distribuição em um cronograma. Para obter um objeto schedule, use o cmdlet New-CMSchedule.

Type:	IResultObject
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableBinaryDeltaReplication

De definir esse parâmetro como $true habilitar a replicação diferencial binária (BDR). Para obter mais informações, consulte Conceitos fundamentais para o gerenciamento de conteúdo no Configuration Manager.

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

Especifique a ID de um pacote a ser configurada. Esse valor é uma ID de pacote padrão, por exemplo: XYZ00020 .

Type:	String
Aliases:	PackageId
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Especifique um objeto package a ser configurar. Para obter esse objeto, use o cmdlet Get-CMPackage.

Type:	IResultObject
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Language

Especifique uma cadeia de caracteres de idioma para o pacote. Você pode usar no máximo 32 caracteres em um formato que você escolhe usar para identificar a versão do idioma. Para identificar um pacote, o Configuration Manager usa os parâmetros Language, Manufacturer, Namee Version. Por exemplo, você pode ter uma versão em inglês e uma versão em alemão do mesmo pacote.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Manufacturer

Especifique o nome do fabricante do software. Você pode usar no máximo 32 caracteres. Para identificar um pacote, o Configuration Manager usa os parâmetros Language, Manufacturer, Namee Version.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MifFileName

Especifique o nome do arquivo MIF (Formato de Informações de Gerenciamento) que contém o status do pacote. A extensão de nome de arquivo deve ser .mif . Use um arquivo MIF de status para gerar relatórios de status detalhados. Para gerar um arquivo MIF de status, seu aplicativo deve chamar a função InstallStatusMIF. Para obter mais informações, consulte Funções de Status MIF.

Se você definir esse parâmetro, quando o cliente executa a implantação, o cliente do Configuration Manager procura no diretório ou no diretório para o arquivo MIF de status de instalação %TEMP% %windir% especificado. O status da instalação indica se o programa foi bem-sucedido.

Se o cliente não encontrar o arquivo, ele procurará todos os arquivos MIF nesses diretórios. Ele faz uma comparação sem maiúsculas de minúsculas dos valores que você especifica para MifName, MifPublishere MifVersion para os valores especificados pelo arquivo MIF. Se o cliente encontrar uma combinação, ele usará o status especificado pelo arquivo MIF como o status de instalação do programa. Se não conseguir encontrar uma combinação ou se você não especificar MifFileName, o cliente usará o código de saída do programa para definir o status de instalação do programa. Um código de saída zero indica que o programa foi realizado com êxito. Quaisquer outros valores indicam códigos de erro específicos do aplicativo.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MifName

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MifPublisher

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MifVersion

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

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MulticastAllow

De definir esse parâmetro como $true permitir que esse pacote seja transferido por meio de multicast. Para obter mais informações, consulte Use multicast para implantarWindows pela rede com o Configuration Manager .

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MulticastEncrypt

Se você habilitar MulticastAllow, de definir esse parâmetro como $true criptografar pacotes de multicast.

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-MulticastTransferOnly

Se você habilitar MulticastAllow, de definir esse parâmetro como $true transferir esse pacote de driver somente por meio de multicast.

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Especifique um nome de pacote. Você pode usar no máximo 250 caracteres. Para identificar um pacote, o Configuration Manager usa os parâmetros Language, Manufacturer, Namee Version.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-NewName

Use esse parâmetro para renomear um pacote.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

Se o pacote contiver arquivos de origem, especifique o local dos arquivos. Você pode especificar um caminho local completo no servidor do site ou um caminho de rede. Certifique-se de que esse local contém todos os arquivos e subdireções que o programa precisa executar, incluindo quaisquer scripts.

Type:	String
Aliases:	PackageSourcePath
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PersistContentInCache

Se você não quiser que o conteúdo desse pacote seja desadado do cache **** do cliente para dar espaço a outros conteúdos, de definir esse parâmetro como $true para persisti-lo no cache do cliente.

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-PrestageBehavior

Especifique o comportamento ao habilitar um ponto de distribuição para conteúdo prestaged:

• ManualCopy: Copie manualmente o conteúdo deste pacote para o ponto de distribuição
• DownloadDelta: Baixar somente alterações de conteúdo para o ponto de distribuição
• OnDemand: Baixe automaticamente o conteúdo quando os pacotes são atribuídos aos pontos de distribuição

Para obter mais informações, consulte Use prestaged content.

Type:	PrestageBehavior
Accepted values:	ManualCopy, DownloadDelta, OnDemand
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Priority

Especifique a ordem na 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. Pacotes com prioridade igual são enviados na ordem em que são criados.

Type:	Priorities
Aliases:	DistributionPriority
Accepted values:	High, Normal, Low
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SendToPreferredDistributionPoint

Se você quiser habilitar a distribuição de conteúdo sob demanda para pontos de distribuição preferenciais, de definir esse parâmetro como $true. Quando você habilita essa configuração, se um cliente solicitar o conteúdo do pacote e o conteúdo não estiver disponível em nenhum ponto de distribuição, o ponto de gerenciamento distribuirá o conteúdo. Para obter mais informações, consulte Distribuição de conteúdo sob demanda.

Type:	Boolean
Aliases:	SendToPreferredDistributionPoints
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Version

Especifique um número de versão para o software. O comprimento máximo dessa cadeia de caracteres é de 32 caracteres. Para identificar um pacote, o Configuration Manager usa os parâmetros Language, Manufacturer, Namee Version.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

System.Object

Links Relacionados

• Export-CMPackage
• Get-CMPackage
• Import-CMPackage
• New-CMPackage
• Remove-CMPackage
• Pacotes e programas no Configuration Manager