Remove-SCSMAllowListClass

Removes the specified classes from the allow list of classes that are used by the Operations Manager CI Connector during synchronization in Service Manager.

Syntax

Remove-SCSMAllowListClass
      [-ClassName] <String[]>
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

The Remove-SCSMAllowListClass cmdlet removes the specified classes from the allow list of classes that the Operations Manager CI Connector uses during synchronization in Service Manager. If the class name is not present in the allow list, the cmdlet returns an argument exception.

Examples

Example 1: Remove a class from the allow list

PS C:\>Remove-SCSMAllowListClass "System.SoftwareItem"
PS C:\> Get-SCSMAllowList
name                                                        mp
----                                                        --
System.Service                                              System.Library
System.Database                                             System.Library
Microsoft.Windows.ApplicationComponent                      Microsoft.Windows.Library
Microsoft.Windows.ComputerRole                              Microsoft.Windows.Library
System.Computer                                             System.Library
System.OperatingSystem                                      System.Library
Microsoft.Windows.LogicalDevice                             Microsoft.Windows.Library
System.SoftwareInstallation                                 System.Library
System.WebSite                                              System.Library

The first command removes the SoftwareItem class from the allow list.

The second command retrieves the allow list to verify that the class has been removed.

Example 2: Attempt to remove an item not in the list

PS C:\>Remove-SCSMAllowListClass "System.SoftwareItem"
Remove-SCSMAllowListClass : Class System.SoftwareItem cannot be removed because it is not in the allow list.
At line:1 char:26
+ Remove-SCSMAllowListClass <<<<  "System.SoftwareItem"
    + CategoryInfo          : InvalidData: (System.SoftwareItem:String) [Remove-SCSMAllowListClass], ArgumentException
    + FullyQualifiedErrorId : Invalid allow list XML,Microsoft.EnterpriseManagement.SMCmdlets.RemoveSCSMAllowListClass

This command attempts to remove a class that is not in the list.

Parameters

-ClassName

Specifies the names of the classes that this cmdlet removes from the allow list of the Operations Manager CI Connector. Each class name must exist in the allow list, and must correspond to an ID property of a <ClassType> management pack element.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ComputerName

Specifies the name of the computer on which the System Center Data Access service runs. The user account that is specified in the Credential parameter must have access rights to the specified computer.

Type:String[]
Position:Named
Default value:Localhost
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 that this cmdlet uses to connect to the server on which the System Center Data Access service runs. The specified user account must have access rights to that server.

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

-SCSession

Specifies an object that represents the session to a Service Manager management server.

Type:Connection[]
Position:Named
Default value:None
Required:False
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.