New-SCSMClassInstance

Adds a class instance to the database.

Syntax

New-SCSMClassInstance [-Class] <ManagementPackClass> [-Property] <Hashtable> [-ComputerName <String[]>]
 [-Credential <PSCredential>] [-PassThru] [-SCSession <Connection[]>] [-Confirm] [-WhatIf] [<CommonParameters>]

Description

The New-SCSMClassInstance cmdlet adds a class instance to the database.

Examples

Example 1: Create printer class instances

PS C:\>0..9 | ForEach-Object {
  New-SCSMClassInstance (Get-SCSMClass â€"Name "Microsoft.Ad.Printer") @{
    UNCName = \\ContosoPrintServer\Printer$_
    ServerName = "ContosoPrintServer"
    PrinterName = "Printer$_"
    Location = "Contoso Headquarters"
    Notes = "Added by PowerShell script." 
  }
}

These commands create a set of 10 printer class instances named Printer0 through Printer9. The location is set to "Contoso Headquarters", and they are all associated with the ServerName "ContosoPrintServer".

Parameters

-Class

Specifies the class on which the new instance is based. You can use the Get-SCClass cmdlet to obtain the ManagementPackClass object that is required for this parameter.

Type:ManagementPackClass
Required:True
Position:1
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-ComputerName

Specifies a computer with which to establish a connection. The computer must be running the System Center Data Access service. The default value is the computer for the current management group connection.

Valid formats include a NetBIOS name, an IP address, or a fully qualified domain name (FQDN). To specify the local computer, type the computer name, "localhost", or a dot (.).

Type:String[]
Required:False
Position:Named
Default value:Localhost
Accept pipeline input:False
Accept wildcard characters:False
-Credential

Specifies a user account under which the management group connection will run. The account must have access to the server that is specified in the ComputerName parameter, if the server is specified. The default value is the current user.

You can enter a PSCredential object that is returned by the Get-Credential cmdlet.

Type:PSCredential
Required:False
Position:Named
Default value:Current user context
Accept pipeline input:False
Accept wildcard characters:False
-PassThru

Specifies the output object that represents the new class instance object. This output object can be passed to other cmdlets.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Property

A hashtable of property-value pairs representing the property values of the new instance. Each key of the hashtable must be the name of a valid property within the class that is specified in the Class parameter and each value must be a valid object that can be stored in the property of its corresponding key.

Type:Hashtable
Required:True
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SCSession

Specifies a connection to a management server. The default value is the current management group connection.

You can enter a management group connection object that is returned by the Get-SCManagementGroupConnection cmdlet.

Type:Connection[]
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
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.

Type:SwitchParameter
Aliases:wi
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

You can pipe a class to the *Class* parameter of the **New-SCSMClassInstance** cmdlet, for example, the object that is returned by the **Get-SCClass** cmdlet.

Outputs

This cmdlet does not generate any output.