Set-CMDriverPackage

Modificare un pacchetto driver.

Sintassi

Set-CMDriverPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-DriverManufacturer <String>]
   [-DriverModel <String>]
   [-DriverPackageSource <String>]
   -InputObject <IResultObject>
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priority>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDriverPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-DriverManufacturer <String>]
   [-DriverModel <String>]
   [-DriverPackageSource <String>]
   -Id <String>
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   [-NewName <String>]
   [-PassThru]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priority>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDriverPackage
   [-CopyToPackageShareOnDistributionPoint <Boolean>]
   [-CustomPackageShareName <String>]
   [-Description <String>]
   [-DisconnectUserFromDistributionPoint <Boolean>]
   [-DisconnectUserFromDistributionPointMins <UInt32>]
   [-DisconnectUserFromDistributionPointRetryCount <UInt32>]
   [-DistributionPointUpdateSchedule <IResultObject>]
   [-DriverManufacturer <String>]
   [-DriverModel <String>]
   [-DriverPackageSource <String>]
   [-MulticastAllow <Boolean>]
   [-MulticastEncrypt <Boolean>]
   [-MulticastTransferOnly <Boolean>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-PrestageBehavior <PrestageBehavior>]
   [-Priority <Priority>]
   [-SendToPreferredDistributionPoint <Boolean>]
   [-Version <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per modificare un pacchetto driver.

Per altre informazioni, vedere Gestire i driver 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: Configurare il produttore e il modello di un pacchetto driver

Questo comando configura il produttore e il modello del pacchetto driver con l'ID XYZ00091.

Set-CMDriverPackage -PackageId "XYZ00091" -DriverManufacturer "Microsoft" -DriverModel "Surface 2"

Parametri

-Confirm

Richiede la conferma prima di eseguire il 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 driver 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 questo pacchetto driver.

Tipo:Boolean
Alias: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
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Specificare una descrizione facoltativa di un pacchetto driver per identificarlo.

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: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:DisconnectUsersFromDistributionPointsMinutes
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisconnectUserFromDistributionPointRetryCount

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

Tipo:UInt32
Alias: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

-DriverManufacturer

Usare questo parametro per impostare il produttore del dispositivo. La lunghezza massima è di 100 caratteri.

Usarlo con il parametro DriverModel . È possibile usarli per gestire il catalogo driver e con la pre-memorizzazione nella cache della sequenza di attività. Per altre informazioni, vedere Configurare il contenuto della pre-cache per le sequenze di attività.

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

-DriverModel

Usare questo parametro per impostare il modello del dispositivo. La lunghezza massima è di 100 caratteri.

Usarlo con il parametro DriverManufacturer . È possibile usarli per gestire il catalogo driver e con la pre-memorizzazione nella cache della sequenza di attività. Per altre informazioni, vedere Configurare il contenuto della pre-cache per le sequenze di attività.

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

-DriverPackageSource

Specificare un percorso di file per il percorso di rete per l'origine dei file del driver.

Quando si crea un pacchetto driver, il percorso di origine del pacchetto deve puntare a una condivisione di rete vuota che non viene usata da un altro pacchetto driver. Il provider SMS deve disporre delle autorizzazioni di controllo completo per tale percorso.

Quando si aggiungono driver di dispositivo a un pacchetto driver, Configuration Manager lo copia in questo percorso. È possibile aggiungere a un pacchetto driver solo i driver di dispositivo importati e abilitati nel catalogo driver.

Tipo:String
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 driver 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 driver da configurare. Per ottenere questo oggetto, usare il cmdlet Get-CMDriverPackage .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
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 driver da configurare.

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

-NewName

Specificare un nuovo nome per il pacchetto driver.

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

-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à media o bassa. I pacchetti con priorità uguale vengono inviati nell'ordine in cui vengono creati.

Tipo:Priority
Valori accettati:High, Medium, 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 la versione del pacchetto driver. Questo valore è una stringa gestita dall'utente.

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