New-SCSMClassInstance

将类实例添加到数据库。

语法

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

说明

New-SCSMClassInstance cmdlet 向数据库添加类实例。

示例

示例 1:创建打印机类实例

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

这些命令创建一组名为 Printer0 到 Printer9 的 10 个打印机类实例。 该位置设置为“Contoso 总部”,它们都与 ServerName“ContosoPrintServer”相关联。

参数

-Class

指定新实例所基于的类。 可以使用 Get-SCClass cmdlet 获取此参数所需的 ManagementPackClass 对象。

类型:Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-ComputerName

指定要与之建立连接的计算机。 计算机必须运行 System Center Data Access 服务。 默认值为当前管理组连接的计算机。

有效格式包括 NetBIOS 名称、IP 地址或完全限定的域名(FQDN)。 若要指定本地计算机,请键入计算机名称“localhost”或点(.)。

类型:System.String[]
Position:Named
默认值:Localhost
必需:False
接受管道输入:False
接受通配符:False

-Confirm

在运行 cmdlet 之前,提示你进行确认。

类型:System.Management.Automation.SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Credential

指定运行管理组连接的用户帐户。 如果指定了服务器,则帐户必须有权访问在 ComputerName 参数中指定的服务器。 默认值为当前用户。

可以输入 Get-Credential cmdlet 返回的 PSCredential 对象。

类型:System.Management.Automation.PSCredential
Position:Named
默认值:Current user context
必需:False
接受管道输入:False
接受通配符:False

-PassThru

指定表示新类实例对象的输出对象。 此输出对象可以传递给其他 cmdlet。

类型:System.Management.Automation.SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Property

表示新实例的属性值的属性值对的哈希表。 哈希表的每个键都必须是 参数中指定的有效属性的名称,并且每个值必须是一个有效的对象,该对象可以存储在其相应键的属性中。

类型:System.Collections.Hashtable
Position:2
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-SCSession

指定与管理服务器的连接。 默认值为当前管理组连接。

可以输入由 Get-SCManagementGroupConnection cmdlet 返回的管理组连接对象。

类型:Microsoft.SystemCenter.Core.Connection.Connection[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:System.Management.Automation.SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

可以通过管道将类传递给 New-SCSMClassInstance cmdlet 的 参数,例如,Get-SCClass cmdlet 返回的对象。

输出

此 cmdlet 不生成任何输出。