Delen via


Set-CMDriver

SYNOPSIS

Wijzigt de instellingen van een apparaat stuurprogramma.

SYNTAX

SetDriverByResultObject (standaard)

Set-CMDriver [-AddAdministrativeCategory <IResultObject[]>] [-AddBootImagePackage <IResultObject[]>]
 [-AddDriverPackage <IResultObject[]>] [-AddSupportedPlatformName <String[]>]
 [-AdministrativeCategory <IResultObject[]>] [-ClearAdministrativeCategory] [-ClearSupportedPlatformName]
 [-Description <String>] [-DriverSource <String>] [-EnableAndAllowInstall <Boolean>]
 -InputObject <IResultObject> [-NewName <String>] [-PassThru] [-RemoveAdministrativeCategory <IResultObject[]>]
 [-RemoveBootImagePackage <IResultObject[]>] [-RemoveDriverPackage <IResultObject[]>]
 [-RemoveSupportedPlatformName <String[]>] [-RunOnAnyPlatform] [-SupportedPlatformName <String[]>]
 [-UpdateBootImageDistributionPoint <Boolean>] [-UpdateDriverDistributionPoint <Boolean>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetDriverById

Set-CMDriver [-AddAdministrativeCategory <IResultObject[]>] [-AddBootImagePackage <IResultObject[]>]
 [-AddDriverPackage <IResultObject[]>] [-AddSupportedPlatformName <String[]>]
 [-AdministrativeCategory <IResultObject[]>] [-ClearAdministrativeCategory] [-ClearSupportedPlatformName]
 [-Description <String>] [-DriverSource <String>] [-EnableAndAllowInstall <Boolean>] -Id <String>
 [-NewName <String>] [-PassThru] [-RemoveAdministrativeCategory <IResultObject[]>]
 [-RemoveBootImagePackage <IResultObject[]>] [-RemoveDriverPackage <IResultObject[]>]
 [-RemoveSupportedPlatformName <String[]>] [-RunOnAnyPlatform] [-SupportedPlatformName <String[]>]
 [-UpdateBootImageDistributionPoint <Boolean>] [-UpdateDriverDistributionPoint <Boolean>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

SetDriverByName

Set-CMDriver [-AddAdministrativeCategory <IResultObject[]>] [-AddBootImagePackage <IResultObject[]>]
 [-AddDriverPackage <IResultObject[]>] [-AddSupportedPlatformName <String[]>]
 [-AdministrativeCategory <IResultObject[]>] [-ClearAdministrativeCategory] [-ClearSupportedPlatformName]
 [-Description <String>] [-DriverSource <String>] [-EnableAndAllowInstall <Boolean>] -Name <String>
 [-NewName <String>] [-PassThru] [-RemoveAdministrativeCategory <IResultObject[]>]
 [-RemoveBootImagePackage <IResultObject[]>] [-RemoveDriverPackage <IResultObject[]>]
 [-RemoveSupportedPlatformName <String[]>] [-RunOnAnyPlatform] [-SupportedPlatformName <String[]>]
 [-UpdateBootImageDistributionPoint <Boolean>] [-UpdateDriverDistributionPoint <Boolean>]
 [-DisableWildcardHandling] [-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

De cmdlet Set-CMDriver wijzigt de instellingen van een apparaat stuurprogramma in de stuurprogrammacatalogus.

Notitie

Voer Configuration Manager cmdlets uit vanaf Configuration Manager sitestation, bijvoorbeeld PS XYZ:\> . Zie Aan de slag voor meer informatie.

EXAMPLES

Voorbeeld 1: een stuurprogramma wijzigen

PS XYZ:\> $Driver = Get-CMDriver -Name "cdrom.sys"
PS XYZ:\> Set-CMDriver -InputObject $Driver -NewName "testDriver" -Description "Test configuration" -EnableAndAllowInstall $True -RunOnAnyPlatform $True

Met de eerste opdracht wordt een apparaat stuurprogramma met de naam cdrom.sys met behulp van de cmdlet Get-CMDriver. De opdracht slaat dat object op in de $Driver variabele .

Met de tweede opdracht wordt de naam van het stuurprogramma gewijzigd en wordt een beschrijving toegevoegd. De opdracht geeft waarden op voor de parameters EnableAndAllowInstall en RunOnAnyPlatform.

Voorbeeld 2: een stuurprogramma wijzigen met behulp van de pijplijn

PS XYZ:\> Get-CMDriver -Name "cdrom.sys" | Set-CMDriver -NewName testDriver -Description description -EnableAndAllowInstall $True -RunOnAnyPlatform $True

Met deze opdracht wordt een stuurprogramma met de cdrom.sys en wordt het vervolgens aan de huidige cmdlet door gegeven met behulp van de pijplijnoperator. De huidige cmdlet wijzigt de naam van het stuurprogramma en voegt een beschrijving toe. Met de opdracht worden waarden opgegeven voor EnableAndAllowInstall en RunOnAnyPlatform.

PARAMETERS

-AddAdministrativeCategory

Hiermee geeft u een matrix van beheercategorieobjecten die deze cmdlet toevoegt aan een stuurprogramma. Als u een beheercategorieobject wilt verkrijgen, gebruikt u de cmdlet Get-CMCategory.

Type: IResultObject[]
Parameter Sets: (All)
Aliases: AddAdministrativeCategories

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

-AddBootImagePackage

Hiermee geeft u een matrix van opstartinstallatie afbeeldingsobjecten. Gebruik deze parameter om de opstartafbeeldingen op te geven die de apparaat stuurprogramma's kunnen installeren. Als u een opstartafbeeldingsobject wilt verkrijgen, gebruikt u de cmdlet Get-CMBootImage.

Type: IResultObject[]
Parameter Sets: (All)
Aliases:

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

-AddDriverPackage

Hiermee geeft u een matrix van stuurprogrammapakketobjecten. Gebruik deze parameter om de stuurprogrammapakketten op te geven die Configuration Manager gebruikt voor het distribueren van de apparaat stuurprogramma's. Als u een stuurprogrammapakketobject wilt verkrijgen, gebruikt u de cmdlet Get-CMDriverPackage.

Type: IResultObject[]
Parameter Sets: (All)
Aliases:

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

-AddSupportedPlatformName

{{ Vul AddSupportedPlatformName Description }} in

Type: String[]
Parameter Sets: (All)
Aliases: AddSupportedPlatformNames

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

-AdministrativeCategory

Hiermee geeft u een matrix met beheercategorieƫn op. Wijs de apparaatst stuurprogramma's toe aan een beheercategorie voor filterdoeleinden, zoals desktops of Notebooks-categorieƫn.

Als u een beheercategorieobject wilt verkrijgen, gebruikt u de cmdlet Get-CMCategory.

Type: IResultObject[]
Parameter Sets: (All)
Aliases:

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

-ClearAdministrativeCategory

Geeft aan dat deze cmdlet alle beheercategorieobjecten uit het stuurprogramma verwijdert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: ClearAdministrativeCategories

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

-ClearSupportedPlatformName

{{ Vul ClearSupportedPlatformName Description }} in

Type: SwitchParameter
Parameter Sets: (All)
Aliases: ClearSupportedPlatformNames

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Beschrijving

Hiermee geeft u een beschrijving op voor het apparaat stuurprogramma.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableWildcardHandling

Deze parameter behandelt jokertekens als letterlijke tekenwaarden. U kunt deze niet combineren met ForceWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-DriverSource

Hiermee geeft u de bronlocatie van het stuurprogrammapakket. Wanneer u een stuurprogrammapakket maakt, moet de bronlocatie van het pakket wijzen op een lege netwerk share die niet wordt gebruikt door een ander stuurprogrammapakket.

Type: String
Parameter Sets: (All)
Aliases:

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

-EnableAndAllowInstall

Geeft aan of Configuration Manager de stuurprogramma's in staat stelt en dat computers de stuurprogramma's kunnen installeren.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ForceWildcardHandling

Deze parameter verwerkt jokertekens en kan leiden tot onverwacht gedrag (niet aanbevolen). U kunt deze niet combineren met DisableWildcardHandling.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Id

Hiermee geeft u de id van een apparaat stuurprogramma.

Type: String
Parameter Sets: SetDriverById
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InputObject

Hiermee geeft u een stuurprogramma-object. Als u een stuurprogrammaobject wilt verkrijgen, gebruikt u de cmdlet Get-CMDriver.

Type: IResultObject
Parameter Sets: SetDriverByResultObject
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Name

Hiermee geeft u de naam van een apparaat stuurprogramma.

Type: String
Parameter Sets: SetDriverByName
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-NewName

Hiermee geeft u een nieuwe naam op voor het apparaat stuurprogramma.

Type: String
Parameter Sets: (All)
Aliases:

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

-PassThru

Retourneert een -object dat het stuurprogramma vertegenwoordigt. Deze cmdlet genereert standaard geen uitvoer.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-RemoveAdministrativeCategory

Hiermee geeft u een matrix van beheercategorieobjecten die deze cmdlet verwijdert uit een stuurprogramma. Gebruik Get-CMCategory om een beheercategorieobject te verkrijgen.

Type: IResultObject[]
Parameter Sets: (All)
Aliases: RemoveAdministrativeCategories

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

-RemoveBootImagePackage

Hiermee geeft u een matrix van opstartinstallatie afbeeldingsobjecten. Gebruik deze parameter om de opstartafbeeldingen te verwijderen die het apparaat stuurprogramma kunnen installeren. Als u een opstartafbeeldingsobject wilt verkrijgen, gebruikt u de cmdlet Get-CMBootImage.

Type: IResultObject[]
Parameter Sets: (All)
Aliases:

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

-RemoveDriverPackage

Hiermee geeft u een matrix van stuurprogrammapakketobjecten. Gebruik deze parameter om de stuurprogrammapakketten te verwijderen die Configuration Manager gebruikt om de apparaat stuurprogramma's te distribueren. Als u een stuurprogrammapakketobject wilt verkrijgen, gebruikt u de cmdlet Get-CMDriverPackage.

Type: IResultObject[]
Parameter Sets: (All)
Aliases:

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

-RemoveSupportedPlatformName

{{ Vul RemoveSupportedPlatformName Description }} in

Type: String[]
Parameter Sets: (All)
Aliases: RemoveSupportedPlatformNames

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

-RunOnAnyPlatform

Geeft aan dat het apparaat stuurprogramma kan worden uitgevoerd op alle platforms.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-SupportedPlatformName

Hiermee geeft u een matrix met namen van platforms op waarop het apparaat stuurprogramma kan worden uitgevoerd.

Type: String[]
Parameter Sets: (All)
Aliases:

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

-UpdateBootImageDistributionPoint

Geeft aan of Configuration Manager opstartafbeeldingen op hun distributiepunten bij te werkt om de nieuwe stuurprogramma's toe te voegen.

Type: Boolean
Parameter Sets: (All)
Aliases: UpdateDistributionPointsForBootImagePackage, UpdateBootImageDistributionPoints

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

-UpdateDriverDistributionPoint

Geeft aan dat Configuration Manager distributiepunten bij te werken wanneer het apparaat stuurprogramma wordt toegevoegd aan het stuurprogrammapakket.

Type: Boolean
Parameter Sets: (All)
Aliases: UpdateDistributionPointsForDriverPackage, UpdateDriverDistributionPoints

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

Deze cmdlet biedt ondersteuning voor de meest gebruikte parameters: -Debug, - ErrorAction, - ErrorVariable, - InformationAction, -InformationVariable, - OutVariable,-OutBuffer, - PipelineVariable - Verbose, - WarningAction en -WarningVariable. Zie voor meer informatie about_CommonParameters.

INPUTS

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

OUTPUTS

System.Object

OPMERKINGEN

CmDriver uitschakelen

CmDriver inschakelen

Get-CMDriver

Import-CMDriver

Remove-CMDriver

Get-CMCategory

Get-CMBootImage

Get-CMDriverPackage