New-SCSMClassInstance

  • リファレンス
モジュール:
System.Center.Service.Manager

データベースにクラス インスタンスを追加します。

構文

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 コマンドレットによって返されるオブジェクトなど) にクラスをパイプ処理できます。

出力

このコマンドレットは出力を生成しません。