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 对象。
Type: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ComputerName
指定要与之建立连接的计算机。 计算机必须运行 System Center Data Access 服务。 默认值是用于当前管理组连接的计算机。
有效格式包括 NetBIOS 名称、IP 地址或完全限定的域名 (FQDN)。 若要指定本地计算机,请键入该计算机名称、“localhost”或句点 (.)。
Type: | System.String[] |
Position: | Named |
Default value: | Localhost |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
Type: | System.Management.Automation.SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
指定用于运行管理组连接的用户帐户。 如果指定了服务器,则帐户必须有权访问 ComputerName 参数中指定的服务器。 默认值为当前用户。
可以输入 Get-Credential cmdlet 返回的 PSCredential 对象。
Type: | System.Management.Automation.PSCredential |
Position: | Named |
Default value: | Current user context |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
指定表示新的类实例对象的输出对象。 此输出对象可以传递给其他 cmdlet。
Type: | System.Management.Automation.SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Property
表示新实例属性值的属性/值对的哈希表。 哈希表的每个键必须是 类参数中指定的 有效属性的名称,并且每个值必须是一个有效的对象,该对象可以存储在相应键的属性中。
Type: | System.Collections.Hashtable |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SCSession
指定与管理服务器的连接。 默认值是当前管理组连接。
可以输入 cmdlet 返回的管理 Get-SCManagementGroupConnection
组连接对象。
Type: | Microsoft.SystemCenter.Core.Connection.Connection[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。
Type: | System.Management.Automation.SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
可以将类传递给 New-SCSMClassInstance cmdlet 的 Class 参数,例如 Get-SCClass cmdlet 返回的对象。
输出
此 cmdlet 将不生成任何输出。