New-SCSMClassInstance
データベースにクラス インスタンスを追加します。
構文
New-SCSMClassInstance
[-Class] <ManagementPackClass>
[-PassThru]
[-Property] <Hashtable>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
New-SCSMClassInstance コマンドレットは、データベースにクラス インスタンスを追加します。
例
例 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 コマンドレットを使用して、このパラメーターに必要な ManagementPackClass オブジェクトを取得できます。
| Type: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ComputerName
接続を確立するコンピューターを指定します。 コンピューターは、System Center データ アクセス サービスを実行している必要があります。 既定値は、現在の管理グループ接続のコンピューターです。
有効な形式は、NetBIOS 名、IP アドレス、または完全修飾ドメイン名 (FQDN) です。 ローカルのコンピューターを指定するには、コンピューター名、「localhost」、またはドット (.) を入力します。
| Type: | System.String[] |
| Position: | Named |
| Default value: | Localhost |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| 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 コマンドレットによって返される PSCredential オブジェクトを入力できます。
| Type: | System.Management.Automation.PSCredential |
| Position: | Named |
| Default value: | Current user context |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
新しいクラス インスタンス オブジェクトを表す出力オブジェクトを指定します。 この出力オブジェクトは、他のコマンドレットに渡すことができます。
| Type: | System.Management.Automation.SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Property
新しいインスタンスのプロパティ値を表すプロパティと値のペアのハッシュ テーブルです。 ハッシュテーブルの各キーは、 Class パラメーターで指定されたクラス内の有効なプロパティの名前である必要があり、各値は、対応するキーのプロパティに格納できる有効なオブジェクトである必要があります。
| Type: | System.Collections.Hashtable |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SCSession
管理サーバーへの接続を指定します。 既定値は現在の管理グループ接続です。
コマンドレットによって返される管理グループ接続オブジェクトを Get-SCManagementGroupConnection 入力できます。
| Type: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。
| 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 コマンドレットの Class パラメーター (Get-SCClass コマンドレットによって返されるオブジェクトなど) にクラスをパイプ処理できます。
出力
このコマンドレットは出力を生成しません。