Share via


Remove-WdsDriverPackage

Remove-WdsDriverPackage

Removes a driver package from a driver group or removes it from all driver groups and deletes it.

Syntaxe

Parameter Set: GroupById
Remove-WdsDriverPackage -GroupName <String> -Id <Guid> [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: GroupByName
Remove-WdsDriverPackage -GroupName <String> -Name <String> [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: StoreById
Remove-WdsDriverPackage -Id <Guid> -RemoveFiles [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Parameter Set: StoreByName
Remove-WdsDriverPackage -Name <String> -RemoveFiles [-AsJob] [-CimSession <CimSession[]> ] [-ThrottleLimit <Int32> ] [ <CommonParameters>]

Description détaillée

The Remove-WdsDriverPackage cmdlet removes a driver package from a driver group or removes a driver package from all driver groups and deletes it from the Windows Deployment Services driver store. Specify a driver package by its unique name or ID.

To remove a driver package from a driver group, specify the name of the group. A client must have access to at least one group that a driver package belongs to in order to install it.

To remove a driver package from all groups and delete if from the driver store, specify the RemoveFiles parameter. Use the Import-WdsDriverPackage cmdlet to import drivers into the driver store.

Paramètres

-AsJob

Alias

none

Obligatoire ?

false

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-CimSession<CimSession[]>

Exécute l’applet de commande dans une session à distance ou sur un ordinateur distant. Entrez un nom d’ordinateur ou un objet de session, comme la sortie d’une applet de commande New-CimSession ou Get-CimSession. La valeur par défaut est la session active sur l’ordinateur local.

Alias

Session

Obligatoire ?

false

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-GroupName<String>

Specifies the name of a driver group. The cmdlet removes the driver package from this group.

Alias

none

Obligatoire ?

true

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-Id<Guid>

Specifies an ID. This is the ID of the driver package to remove.

Alias

none

Obligatoire ?

true

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

True (ByPropertyName)

Accepter les caractères génériques ?

false

-Name<String>

Specifies a name. This is the unique name of the driver package. If this name is not unique, specify the driver package ID, instead, by using the Id parameter.

Alias

none

Obligatoire ?

true

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

True (ByPropertyName)

Accepter les caractères génériques ?

false

-RemoveFiles

Indicates that this cmdlet removes the driver package from all driver groups and deletes it from the store.

Alias

none

Obligatoire ?

true

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

-ThrottleLimit<Int32>

Spécifie le nombre maximal d’opérations simultanées qui peuvent être établies pour exécuter cette applet de commande. Si ce paramètre est omis ou si la valeur 0 est entrée, Windows PowerShell ® calcule une limitation optimale pour l’applet de commande en fonction du nombre d’applets de commande CIM qui s’exécutent sur l’ordinateur. La limitation s’applique seulement à l’applet de commande actuelle, et non pas à la session ni à l’ordinateur.

Alias

none

Obligatoire ?

false

Position ?

named

Valeur par défaut

none

Accepter l’entrée de pipeline ?

false

Accepter les caractères génériques ?

false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d’informations, consultez about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entrées

Le type d’entrée correspond au type des objets que vous pouvez transmettre à l’applet de commande.

Sorties

Le type de sortie est le type des objets émis par l’applet de commande.

  • Microsoft.Management.Infrastructure.CimInstance#MSFT_WdsDriverPackage

Exemples

Example 1: Remove a driver package from a group by using the package ID

This command removes the driver package that has the specified ID from the group named Drivers for Fabrikam Devices.

PS C:\> Remove-WdsDriverPackage -GroupName "Drivers for Fabrikam Devices" -Id 32d78628-07fb-4e18-adc4-f0ecf8b41bbe

Example 2: Remove a named driver package from a group

This command removes the driver package named Fabrikam Device Driver (x64) from the group named Drivers for Fabrikam Devices.

PS C:\> Remove-WdsDriverPackage -GroupName "Drivers for Fabrikam Devices" -Name "Fabrikam Device Driver (x64)"

Example 3: Remove a driver package from all groups by using the package ID

This command removes the driver package that has the specified ID from all groups and deletes it from the driver store.

PS C:\> Remove-WdsDriverPackage -Id 32d78628-07fb-4e18-adc4-f0ecf8b41bbe -RemoveFiles

Example 4: Remove a named driver package from all groups

This command removes the driver package named Fabrikam Device Driver (x64) from all groups and deletes it from the driver store.

PS C:\> Remove-WdsDriverPackage -Name "Fabrikam Device Driver (x64)" -RemoveFiles

Rubriques connexes

Add-WdsDriverPackage

Disable-WdsDriverPackage

Enable-WdsDriverPackage

Get-WdsDriverPackage

Import-WdsDriverPackage