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