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 オブジェクトを取得できます。
| 型: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ComputerName
接続を確立するコンピューターを指定します。 コンピューターが System Center Data Access サービスを実行している必要があります。 既定値は、現在の管理グループ接続のコンピューターです。
有効な形式には、NetBIOS 名、IP アドレス、または完全修飾ドメイン名 (FQDN) が含まれます。 ローカル コンピューターを指定するには、コンピューター名、"localhost"、またはドット (.) を入力します。
| 型: | System.String[] |
| 配置: | Named |
| 規定値: | Localhost |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
| 型: | System.Management.Automation.SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Credential
管理グループ接続を実行するユーザー アカウントを指定します。 アカウントは、ComputerName パラメーターで指定されているサーバーにアクセスできる必要があります (サーバーが指定されている場合)。 既定値は現在のユーザーです。
Get-Credential コマンドレットによって返される PSCredential オブジェクトを入力できます。
| 型: | System.Management.Automation.PSCredential |
| 配置: | Named |
| 規定値: | Current user context |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PassThru
新しいクラス インスタンス オブジェクトを表す出力オブジェクトを指定します。 この出力オブジェクトは、他のコマンドレットに渡すことができます。
| 型: | System.Management.Automation.SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Property
新しいインスタンスのプロパティ値を表すプロパティと値のペアのハッシュテーブル。 ハッシュテーブルの各キーは、Class パラメーターで指定されたクラス内の有効なプロパティの名前である必要があります。各値は、対応するキーのプロパティに格納できる有効なオブジェクトである必要があります。
| 型: | System.Collections.Hashtable |
| 配置: | 2 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SCSession
管理サーバーへの接続を指定します。 既定値は、現在の管理グループ接続です。
Get-SCManagementGroupConnection コマンドレットによって返される管理グループ接続オブジェクトを入力できます。
| 型: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
| 型: | System.Management.Automation.SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
New-SCSMClassInstance コマンドレットの Class パラメーター (たとえば、Get-SCClass コマンドレットによって返されるオブジェクト) にクラスをパイプできます。
出力
このコマンドレットは出力を生成しません。