Set-CMPackage
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çãoDownloadDelta
: Baixar somente alterações de conteúdo para o ponto de distribuiçãoOnDemand
: 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