Disable-SCDWJobCategory

Reference

Module:: Microsoft.EnterpriseManagement.Warehouse.Cmdlets

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