Disable-SCDWJobCategory
Disables all jobs within a job category.
Syntax
Disable-SCDWJobCategory
[-JobCategoryName] <String>
[-ComputerName <String>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The Disable-SCDWJobCategory cmdlet disables all jobs within a job category.
Examples
Example 1: Disable jobs by category
PS C:\>Disable-SCDWJobCategory -ComputerName "serverDW72" -JobCategoryName "CubeProcessing"
This command disables the jobs in the CubeProssing
category.
Example 2: Disable jobs using credentials
PS C:\>$credUser = Get-Credential
PS C:\>Disable-SCDWJobCategory -ComputerName "serverDW72" -JobCategoryName "CubeProcessing" â€"Credential $credUser
The first command stores user credentials for the Credential parameter.
The second command disables the jobs in the CubeProssing
category using the specified credentials.
Example 3: Display job enabled/disabled status
PS C:\>Get-SCDWJob -ComputerName "serverDW72" | Select-Object -Property CategoryName, IsEnabled -Unique | Format-Table -Property CategoryName, IsEnabled -AutoSize
This command provides information about enabled and disabled jobs in the job categories. If all the jobs in the category are either enabled or disabled, the value in the IsEnabled column in the output reflects that value.
If at least one job in a job category has an opposite IsEnabled value from the other jobs in the same category, the job category name is repeated with that value (as is the case for the Load
category in the example output).
This is achieved by using the Unique parameter with the Select-Object command.
Parameters
-ComputerName
Specifies the name of the computer on which the System Center Data Access service is running. The user account that is defined in the Credential parameter must have access rights to the specified computer. You can omit this parameter only if the System Center Data Access Service is running on the same computer that has Service Manager installed.
Type: | String |
Aliases: | CN |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Specifies the credentials to use when you are connecting to the server on which the System Center Data Access service is running. The user account that is provided must have access to that server.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobCategoryName
Specifies the name of the job category. You can use the Get-SCDWJob cmdlet to retrieve this value. Examples of valid job categories are Maintenance, Extract, Load, and Transform.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
None.
You cannot pipe input to this cmdlet.
Outputs
None.
This cmdlet does not generate any output.