New-SCSMClassInstance

Article
12/08/2015

New-SCSMClassInstance

Adds a class instance to the database.

Syntax

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

Detailed Description

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

Parameters

-Class<ManagementPackClass>

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.

Aliases	none
Required?	true
Position?	1
Default Value	none
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-ComputerName<String[]>

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 (.).

Aliases	none
Required?	false
Position?	named
Default Value	localhost
Accept Pipeline Input?	true (ByValue)
Accept Wildcard Characters?	false

-Credential<PSCredential>

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.

Aliases	none
Required?	false
Position?	named
Default Value	Current user context
Accept Pipeline Input?	true (ByValue)
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.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Property<Hashtable>

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.

Aliases	none
Required?	true
Position?	2
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-SCSession<Connection[]>

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.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	true (ByValue)
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.

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

The output type is the type of the objects that the cmdlet emits.

This cmdlet does not generate any output.

Examples

Example 1: Create printer class instances

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".

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." 
  }
}

Get-SCSMClassInstance

Remove-SCSMClassInstance

Update-SCSMClassInstance

New-SCSMClassInstance