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çãoDownloadDelta: Descarregue apenas alterações de conteúdo no ponto de distribuiçãoOnDemand: 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.