Set-CMPackage

  • Riferimento
Modulo:
ConfigurationManager

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

Utilizzare questo cmdlet per modificare le impostazioni di un pacchetto. Per altre informazioni, vedi 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 ulteriori 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 ID ST120001e archivia i risultati nella $Pkg variabile. 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters: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. Usa 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 in cui distribuisci questo pacchetto.

Type:Boolean
Aliases:ShareContent, CopyToPackageShareOnDistributionPoints
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CustomPackageShareName

Se si abilita CopyToPackageShareOnDistributionPoint, è possibile utilizzare 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.

Type:String
Aliases:ShareName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

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

-DisableWildcardHandling

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

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

-DisconnectUserFromDistributionPoint

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

Type:Boolean
Aliases:ForceDisconnectEnabled, DisconnectUsersFromDistributionPoints
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisconnectUserFromDistributionPointMins

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

Type:UInt32
Aliases:ForcedDisconnectDelay, DisconnectUsersFromDistributionPointsMinutes, DisconnectUserFromDistributionPointsMins, DisconnectUserFromDistributionPointsMinutes
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisconnectUserFromDistributionPointRetry

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

Type:UInt32
Aliases:ForceDisconnectNumRetries, DisconnectUsersFromDistributionPointsRetries
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DistributionPointUpdateSchedule

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

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

-EnableBinaryDeltaReplication

Impostare questo parametro su $true per abilitare la replica differenziale binaria (BDR). Per ulteriori informazioni, vedere Concetti fondamentali per la gestione del contenuto in Configuration Manager.

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

-ForceWildcardHandling

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

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

-Id

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

Type:String
Aliases:PackageId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

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

Type:IResultObject
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Language

Specificare una stringa di lingua per il pacchetto. È possibile utilizzare un massimo di 32 caratteri in un formato che si sceglie di utilizzare per identificare la versione della lingua. Per identificare un pacchetto, Configuration Manager usa i parametri Language, Manufacturer, Namee Version. Ad esempio, puoi avere una versione inglese e una tedesca dello stesso pacchetto.

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

-Manufacturer

Specificare il nome del produttore del software. È possibile utilizzare un massimo di 32 caratteri. Per identificare un pacchetto, Configuration Manager usa i parametri Language, Manufacturer, Namee Version.

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

-MifFileName

Specifica il nome del file MIF (Management Information Format) che contiene lo stato del pacchetto. L'estensione del nome file deve essere .mif . Usa un file MIF di stato per generare relazioni dettagliate sullo stato. Per generare un file MIF di stato, l'applicazione deve chiamare la funzione InstallStatusMIF. Per ulteriori informazioni, vedere Status MIF Functions.

Se si imposta questo parametro, quando il client esegue la distribuzione, il client di Configuration Manager cerca nella directory o nella directory il file MIF dello stato di %TEMP% %windir% 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. Viene eseguito un confronto senza distinzione tra maiuscole e minuscole dei valori specificati per MifName, MifPublishere MifVersion con i valori specificati dal file MIF. Se il client trova una corrispondenza, utilizza 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 utilizza il codice di uscita del programma per impostare lo stato di installazione del 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.

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

-MifName

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

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

-MifPublisher

Specifica l'autore del software del pacchetto per la corrispondenza MIF, fino a 32 caratteri. Per ulteriori informazioni, vedere il parametro MifFileName.

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

-MifVersion

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

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

-MulticastAllow

Impostare questo parametro su $true per consentire il trasferimento del pacchetto tramite multicast. Per ulteriori informazioni, vedere Use multicast to deploy Windows over the network with Configuration Manager.

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

-MulticastEncrypt

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

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

-MulticastTransferOnly

Se abiliti MulticastAllow, imposta questo parametro su $true trasferire solo questo pacchetto driver tramite multicast.

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

-Name

Specificare un nome di pacchetto. È possibile utilizzare un massimo di 250 caratteri. Per identificare un pacchetto, Configuration Manager usa i parametri Language, Manufacturer, Namee Version.

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

-NewName

Utilizzare questo parametro per rinominare un pacchetto.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 necessari per l'esecuzione del programma, inclusi eventuali script.

Type:String
Aliases:PackageSourcePath
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PersistContentInCache

Se non vuoi che il contenuto di questo pacchetto evade dalla cache client per fare spazio ad altri contenuti, imposta questo parametro su $true per renderlo permanente nella cache client.

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

-PrestageBehavior

Specificare il comportamento quando si abilita un punto di distribuzione per il contenuto prestaged:

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

Per ulteriori informazioni, vedere Use prestaged content.

Type:PrestageBehavior
Accepted values:ManualCopy, DownloadDelta, OnDemand
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Priority

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

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

Type:Priorities
Aliases:DistributionPriority
Accepted values:High, Normal, Low
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SendToPreferredDistributionPoint

Se si desidera abilitare la distribuzione del contenuto su richiesta nei punti di distribuzione preferiti, impostare questo parametro su $true. Quando abiliti 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 ulteriori informazioni, vedere Distribuzione del contenuto su richiesta.

Type:Boolean
Aliases:SendToPreferredDistributionPoints
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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 Language, Manufacturer, Namee Version.

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object