Condividi tramite


Set-CMPackage

Modificare un pacchetto.

Sintassi

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

Descrizione

Usare questo cmdlet per modificare le impostazioni di un pacchetto. Per altre informazioni, vedere Pacchetti e programmi in Configuration Manager.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Rinominare un pacchetto e aggiungere una descrizione

Questo comando rinomina il pacchetto con ID ST120001 in ScriptsPackage02 e aggiunge una descrizione.

Set-CMPackage -Id "ST120001" -NewName "ScriptsPackage02" -Description "This package deploys scripts that run on a recurring schedule."

Esempio 2: Modificare il percorso di origine del pacchetto

Il primo comando ottiene il pacchetto con l'ID ST120001 e archivia i risultati nella variabile $Pkg . Il secondo comando modifica il percorso di origine del pacchetto.

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

Parametri

-Confirm

Aggiungere questo parametro per richiedere conferma prima dell'esecuzione del cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CopyToPackageShareOnDistributionPoint

I client possono sempre scaricare un pacchetto da un punto di distribuzione. Se si imposta questo parametro su $true, il sito lo rende disponibile tramite una condivisione di rete denominata nei punti di distribuzione. Usare CustomPackageShareName per specificare un nome di condivisione personalizzato.

Quando si abilita questa opzione, è necessario più spazio nei punti di distribuzione. Si applica a tutti i punti di distribuzione a cui si distribuisce il pacchetto.

Tipo:Boolean
Alias:ShareContent, CopyToPackageShareOnDistributionPoints
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-CustomPackageShareName

Se si abilita CopyToPackageShareOnDistributionPoint, è possibile usare questo parametro per personalizzare il nome della condivisione. La lunghezza massima è di 127 caratteri e non può includere i caratteri seguenti: " / [ ] : | < > + = ; , ? *. È possibile specificare un nome di condivisione e un nome di cartella, ma il massimo per ognuno è 80 caratteri. Ad esempio, ShareName\FolderName.

Tipo:String
Alias:ShareName
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Specificare una descrizione facoltativa del pacchetto per identificarlo. È possibile usare un massimo di 128 caratteri.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisconnectUserFromDistributionPoint

Questa opzione è deprecata. Imposta la proprietà ForcedDisconnectEnabled del pacchetto driver.

Tipo:Boolean
Alias:ForceDisconnectEnabled, DisconnectUsersFromDistributionPoints
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisconnectUserFromDistributionPointMins

Questa opzione è deprecata. Imposta la proprietà ForcedDisconnectDelay del pacchetto driver.

Tipo:UInt32
Alias:ForcedDisconnectDelay, DisconnectUsersFromDistributionPointsMinutes, DisconnectUserFromDistributionPointsMins, DisconnectUserFromDistributionPointsMinutes
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisconnectUserFromDistributionPointRetry

Questa opzione è deprecata. Imposta la proprietà ForcedDisconnectNumRetries del pacchetto driver.

Tipo:UInt32
Alias:ForceDisconnectNumRetries, DisconnectUsersFromDistributionPointsRetries
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DistributionPointUpdateSchedule

Usare questo parametro per aggiornare i punti di distribuzione in base a una pianificazione. Per ottenere un oggetto pianificazione, usare il cmdlet New-CMSchedule .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableBinaryDeltaReplication

Impostare questo parametro su $true per abilitare la replica differenziale binaria.Set this parameter to $true to enable binary differential replication (BDR). Per altre informazioni, vedere Concetti fondamentali per la gestione dei contenuti in Configuration Manager.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

Specificare l'ID di un pacchetto da configurare. Questo valore è un ID pacchetto standard, ad esempio: XYZ00020.

Tipo:String
Alias:PackageId
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specificare un oggetto pacchetto da configurare. Per ottenere questo oggetto, usare il cmdlet Get-CMPackage .

Tipo:IResultObject
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Language

Specificare una stringa di lingua per il pacchetto. È possibile usare un massimo di 32 caratteri in un formato che si sceglie di usare per identificare la versione della lingua. Per identificare un pacchetto, Configuration Manager usa i parametri Lingua, Produttore, Nome e Versione . Ad esempio, è possibile avere una versione in inglese e una versione tedesca dello stesso pacchetto.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Manufacturer

Specificare il nome del produttore per il software. È possibile usare un massimo di 32 caratteri. Per identificare un pacchetto, Configuration Manager usa i parametri Lingua, Produttore, Nome e Versione .

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MifFileName

Specificare il nome del file MIF (Management Information Format) che contiene lo stato del pacchetto. L'estensione del nome file deve essere .mif. Usare un file MIF di stato per generare report dettagliati sullo stato. Per generare un file MIF di stato, l'applicazione deve chiamare la funzione InstallStatusMIF. Per altre informazioni, vedere Funzioni MIF di stato.

Se si imposta questo parametro, quando il client esegue la distribuzione, il client di Configuration Manager cerca nella directory o nella %TEMP%%windir% directory il file MIF di stato dell'installazione specificato. Lo stato di installazione indica se il programma è stato eseguito correttamente.

Se il client non trova il file, cerca tutti i file MIF in tali directory. Esegue un confronto senza distinzione tra maiuscole e minuscole dei valori specificati per MifName, MifPublisher e MifVersion con i valori specificati dal file MIF. Se il client trova una corrispondenza, usa lo stato specificato dal file MIF come stato di installazione per il programma. Se non è possibile trovare una corrispondenza o se non si specifica MifFileName, il client usa il codice di uscita del programma per impostare lo stato di installazione per il programma. Un codice di uscita pari a zero indica che il programma è stato eseguito correttamente. Qualsiasi altro valore indica codici di errore specifici dell'applicazione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MifName

Specificare il nome del pacchetto per la corrispondenza MIF, fino a 50 caratteri. Per altre informazioni, vedere il parametro MifFileName .

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MifPublisher

Specificare l'editore software del pacchetto per la corrispondenza MIF, fino a 32 caratteri. Per altre informazioni, vedere il parametro MifFileName .

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MifVersion

Specificare il numero di versione del pacchetto per la corrispondenza MIF, fino a 32 caratteri. Per altre informazioni, vedere il parametro MifFileName .

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MulticastAllow

Impostare questo parametro su $true per consentire il trasferimento del pacchetto tramite multicast. Per altre informazioni, vedere Usare il multicast per distribuire Windows in rete con Configuration Manager.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MulticastEncrypt

Se si abilita MulticastAllow, impostare questo parametro su $true per crittografare i pacchetti multicast.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MulticastTransferOnly

Se si abilita MulticastAllow, impostare questo parametro su $true per trasferire il pacchetto driver solo tramite multicast.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specificare il nome di un pacchetto. È possibile usare un massimo di 250 caratteri. Per identificare un pacchetto, Configuration Manager usa i parametri Lingua, Produttore, Nome e Versione .

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NewName

Usare questo parametro per rinominare un pacchetto.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Path

Se il pacchetto contiene file di origine, specificare il percorso dei file. È possibile specificare un percorso locale completo nel server del sito o un percorso di rete. Assicurarsi che questo percorso contenga tutti i file e le sottodirectory che il programma deve eseguire, inclusi gli script.

Tipo:String
Alias:PackageSourcePath
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PersistContentInCache

Se non si vuole che il contenuto di questo pacchetto scada dalla cache client per fare spazio ad altri contenuti, impostare questo parametro su $true per renderlo permanente nella cache client.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PrestageBehavior

Specificare il comportamento quando si abilita un punto di distribuzione per il contenuto pre-installato:

  • ManualCopy: copiare manualmente il contenuto di questo pacchetto nel punto di distribuzione
  • DownloadDelta: scaricare solo le modifiche al contenuto nel punto di distribuzione
  • OnDemand: scaricare automaticamente il contenuto quando i pacchetti vengono assegnati ai punti di distribuzione

Per altre informazioni, vedere Usare il contenuto pre-installato.

Tipo:PrestageBehavior
Valori accettati:ManualCopy, DownloadDelta, OnDemand
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Priority

Specificare l'ordine in cui il sito invia il contenuto ad altri siti e ai punti di distribuzione del sito.

Il sito invia contenuto con priorità elevata prima dei pacchetti con priorità normale o bassa. I pacchetti con priorità uguale vengono inviati nell'ordine in cui vengono creati.

Tipo:Priorities
Alias:DistributionPriority
Valori accettati:High, Normal, Low
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SendToPreferredDistributionPoint

Se si vuole abilitare la distribuzione del contenuto su richiesta nei punti di distribuzione preferiti, impostare questo parametro su $true. Quando si abilita questa impostazione, se un client richiede il contenuto per il pacchetto e il contenuto non è disponibile in alcun punto di distribuzione, il punto di gestione distribuisce il contenuto. Per altre informazioni, vedere Distribuzione del contenuto su richiesta.

Tipo:Boolean
Alias:SendToPreferredDistributionPoints
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Version

Specificare un numero di versione per il software. La lunghezza massima di questa stringa è di 32 caratteri. Per identificare un pacchetto, Configuration Manager usa i parametri Lingua, Produttore, Nome e Versione .

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object