Disable-CMDriver
Disable-CMDriver
Disables a software driver or a device driver.
Syntax
Parameter Set: SearchByIdMandatory
Disable-CMDriver -Id <String[]> [-SecuredScopeNames <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByNameMandatory
Disable-CMDriver -Name <String[]> [-SecuredScopeNames <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByValueMandatory
Disable-CMDriver -InputObject <IResultObject> [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Disable-CMDriver cmdlet disables a software driver or a device driver in Microsoft System Center 2012 SP1 Configuration Manager.
Parameters
-Id<String[]>
Specifies an array of identifiers for a driver.
Aliases |
CIId |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-InputObject<IResultObject>
Specifies a driver object. To obtain a driver object, use the Get-CMDriver object.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Name<String[]>
Specifies an array of names for a driver.
Aliases |
LocalizedDisplayName |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SecuredScopeNames<String>
Specifies the names of security scopes. A security scope name can be Default or the name of a custom-created security scope.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1: Disable a driver that is specified by its identifier
This command disables a device driver that is specified by its identifier.
PS C:\> Disable-CMDriver -Id "16777705"
Example 2: Disable a device driver that is specified by its name
This command disables a device driver that is specified by its name.
PS C:\> Disable-CMDriver -Name "cdrom.inf"
Example 3: Disable a driver that is specified by an input object
The first command uses the Get-CMDriver cmdlet to assign the variable $Driver to the device driver that is specified by using its identifier.
The second command disables the device driver that is specified by the variable $Driver.
PS C:\> $Driver = Get-CMDriver -Id "16777705"
PS C:\> Disable-CMDriver -InputObject $Driver