Set-CMDriverPackage

Modulo:

ConfigurationManager

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

Utilizzare questo cmdlet per modificare un pacchetto driver.

Per ulteriori 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 ulteriori 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 ID XYZ00091.

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

Parametri

-Confirm

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

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

-Description

Specificare una descrizione facoltativa di un pacchetto driver per identificarlo.

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

-DisconnectUserFromDistributionPointRetryCount

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

Type:	UInt32
Aliases:	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

-DriverManufacturer

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

Utilizzarlo con il parametro DriverModel. Puoi usarli per gestire il catalogo driver e con la pre-memorizzazione nella cache della sequenza di attività. Per ulteriori informazioni, vedere Configure pre-cache content for task sequences.

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

-DriverModel

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

Utilizzarlo con il parametro DriverManufacturer. Puoi usarli per gestire il catalogo driver e con la pre-memorizzazione nella cache della sequenza di attività. Per ulteriori informazioni, vedere Configure pre-cache content for task sequences.

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

-DriverPackageSource

Specificare un percorso di file per il percorso di rete in cui creare i file del driver.

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

Quando aggiungi driver di dispositivo a un pacchetto driver, Configuration Manager lo copia in questo percorso. Puoi aggiungere a un pacchetto driver solo driver di dispositivo importati e abilitati nel catalogo driver.

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

Type:	IResultObject
Position:	Named
Default value:	None
Accept pipeline input:	True
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 il nome di un pacchetto driver da configurare.

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

-NewName

Specificare un nuovo nome per il pacchetto driver.

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

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

Type:	Priority
Accepted values:	High, Medium, 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

Specifica la versione del pacchetto driver. Questo valore è una stringa che si gestisce.

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

Collegamenti correlati

• Export-CMDriverPackage
• Get-CMDriverPackage
• Import-CMDriverPackage
• New-CMDriverPackage
• Remove-CMDriverPackage
• Gestire i driver in Configuration Manager