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