Partilhar via


Set-CMPackage

SYNOPSIS

Modificar um pacote.

SYNTAX

SetByValue (Padrão)

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>]

SetById

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>]

SetByName

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 uma embalagem. Para obter mais informações, consulte Pacotes e programas no Gestor de Configurações.

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: Mude o nome de um pacote e adicione uma descrição

Este comando renomea o 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 da fonte do pacote

O primeiro comando recebe o pacote que tem o ID ST120001, e armazena os resultados na variável $Pkg. O segundo comando altera o caminho da fonte do pacote.

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

PARAMETERS

-Confirm

Adicione este parâmetro para solicitar a confirmação antes do cmdlet ser executado.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-CopyToPackageShareOnDistributionPoint

Os clientes podem sempre descarregar um pacote a partir de um ponto de distribuição. Se definir este parâmetro para $true, o site disponibiliza-o através de uma partilha de rede nomeada em pontos de distribuição. Utilize o Nome CustomPackageShare 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 a que distribui este pacote.

Type: Boolean
Parameter Sets: (All)
Aliases: ShareContent, CopyToPackageShareOnDistributionPoints

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

-CustomPackageShareName

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

Type: String
Parameter Sets: (All)
Aliases: ShareName

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

-Descrição

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

Type: String
Parameter Sets: (All)
Aliases:

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

-DisconnectUserFromDistributionPoint

Esta opção é depreciada. Define a propriedade ForcedDisconnectEnabled do pacote do condutor.

Type: Boolean
Parameter Sets: (All)
Aliases: ForceDisconnectEnabled, DisconnectUsersFromDistributionPoints

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

-DisconnectUserFromDistributionPointMins

Esta opção é depreciada. Define a propriedade ForcedDisconnectDelay do pacote do motorista.

Type: UInt32
Parameter Sets: (All)
Aliases: ForcedDisconnectDelay, DisconnectUsersFromDistributionPointsMinutes, DisconnectUserFromDistributionPointsMins, DisconnectUserFromDistributionPointsMinutes

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

-DisconnectUserFromDistributionPointRetry

Esta opção é depreciada. Define a propriedade ForcedDisconnectNumRetries do pacote do condutor.

Type: UInt32
Parameter Sets: (All)
Aliases: ForceDisconnectNumRetries, DisconnectUsersFromDistributionPointsRetries

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

-DistributionPointUpdateSchedule

Utilize este parâmetro para atualizar pontos de distribuição num horário. Para obter um objeto de agenda, use o cmdlet New-CMSchedule.

Type: IResultObject
Parameter Sets: (All)
Aliases:

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

-EnableBinaryDeltaReplicação

Desente este parâmetro para $true para permitir a replicação diferencial binária (BDR). Para obter mais informações, consulte conceitos fundamentais para a gestão de conteúdos no Gestor de Configurações.

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

- ID

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

Type: String
Parameter Sets: SetById
Aliases: PackageId

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InputObject

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

Type: IResultObject
Parameter Sets: SetByValue
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Língua

Especifique uma cadeia linguística para o pacote. Pode utilizar um máximo de 32 caracteres num formato que escolhe usar para identificar a versão linguística. Para identificar um pacote, o Gestor de Configuração utiliza os parâmetros idiomas, fabricante, nome e versão. Por exemplo, pode ter uma versão em inglês e uma versão alemã do mesmo pacote.

Type: String
Parameter Sets: (All)
Aliases:

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

-Fabricante

Especifique o nome do fabricante para o software. Pode utilizar até 32 carateres. Para identificar um pacote, o Gestor de Configuração utiliza os parâmetros idiomas, fabricante, nome e versão.

Type: String
Parameter Sets: (All)
Aliases:

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

-MifFileName

Especifique o nome do ficheiro Formato de Informação de Gestão (MIF) que contém o estado do pacote. A extensão do nome do ficheiro deve ser .mif . Utilize um ficheiro MIF de estado para gerar relatórios de estado detalhados. Para gerar um ficheiro MIF de estado, a sua aplicação deve chamar a função InstallStatusMIF. Para obter mais informações, consulte as funções de Estado MIF.

Se definir este parâmetro, quando o cliente executa a implementação, o cliente Do Gestor de Configuração procura no diretório ou no %TEMP% %windir% diretório para o ficheiro MIF de estado de instalação que especifica. O estado de instalação indica se o programa foi bem sucedido.

Se o cliente não encontrar o ficheiro, procura todos os ficheiros MIF nesses diretórios. Faz uma comparação caso-insensível dos valores que especifica para MifName, MifPublisher e MifVersion com os valores que o ficheiro MIF especifica. 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 encontrar uma correspondência, ou se não especificar o 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 bem sucedido. Quaisquer outros valores indicam códigos de erro específicos da aplicação.

Type: String
Parameter Sets: (All)
Aliases:

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

-MifName

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

Type: String
Parameter Sets: (All)
Aliases:

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

-MifPublisher

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

Type: String
Parameter Sets: (All)
Aliases:

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

-MifVersion

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

Type: String
Parameter Sets: (All)
Aliases:

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

-MulticastAllow

Desa esta definição deste parâmetro para $true para permitir que este pacote seja transferido através de multicast. Para obter mais informações, consulte utilizar multicast para implementar Windows na rede com o Gestor de Configuração.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-MulticastEncrypt

Se ativar o MulticastAllow, desaprote este parâmetro para $true para encriptar pacotes multicast.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-MulticastTransferOnamente

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

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Name

Especifique um nome de pacote. Pode utilizar um máximo de 250 caracteres. Para identificar um pacote, o Gestor de Configuração utiliza os parâmetros idiomas, fabricante, nome e versão.

Type: String
Parameter Sets: SetByName
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Novo Nome

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

Type: String
Parameter Sets: (All)
Aliases:

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

- PassThru

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: 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 subdireções que o programa precisa de executar, incluindo quaisquer scripts.

Type: String
Parameter Sets: (All)
Aliases: PackageSourcePath

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

-PersistContentInCache

Se não quiser que o conteúdo deste pacote encate fora da cache do cliente para abrir espaço para outros conteúdos, desa um parâmetro para $true persistir na cache do cliente.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-PrestageBehavior

Especifique o comportamento quando ativar um ponto de distribuição para conteúdo satisfatório:

  • ManualCopy: Copiar manualmente o conteúdo desta embalagem para o ponto de distribuição
  • DownloadDelta: Descarregue apenas alterações de conteúdo no ponto de distribuição
  • OnDemand: Descarregue automaticamente o conteúdo quando os pacotes são atribuídos a pontos de distribuição

Para obter mais informações, consulte o conteúdo de prestaçãode informação .

Type: PrestageBehavior
Parameter Sets: (All)
Aliases:
Accepted values: ManualCopy, DownloadDelta, OnDemand

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

-Prioridade

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

Type: Priorities
Parameter Sets: (All)
Aliases: DistributionPriority
Accepted values: High, Normal, Low

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

-SendToPreferredDistributionPoint

Se pretender permitir a distribuição de conteúdos a pedido para pontos de distribuição preferidos, desaponte este parâmetro para $true. Quando ativa esta definição, se um cliente solicitar o conteúdo do pacote e o conteúdo não estiver disponível em quaisquer pontos de distribuição, então o ponto de gestão distribui o conteúdo. Para obter mais informações, consulte a distribuição de conteúdos a pedido.

Type: Boolean
Parameter Sets: (All)
Aliases: SendToPreferredDistributionPoints

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

-Versão

Especifique um número de versão para o software. O comprimento máximo desta corda é de 32 caracteres. Para identificar um pacote, o Gestor de Configuração utiliza os parâmetros idiomas, fabricante, nome e versão.

Type: String
Parameter Sets: (All)
Aliases:

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: False
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.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

Sistema.Objeto

NOTAS

Exportação-CMPackage

Get-CMPackage

Importação-CMPackage

Pacote novo CM

Remover-CMPackage

Pacotes e programas em Gestor de Configuração