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