New-CMConfigurationItem

New-CMConfigurationItem

Creates a configuration item.

構文

Parameter Set: New
New-CMConfigurationItem -CreationType <CICreationType> {MacOS | MobileDevice | None | WindowsApplication | WindowsOS} -Name <String> [-Category <String[]> ] [-Description <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: NewChild
New-CMConfigurationItem -Name <String> -ParentConfigurationItem <IResultObject> [-Category <String[]> ] [-Description <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The New-CMConfigurationItem cmdlet creates a configuration item in Microsoft System Center 2012 Configuration Manager. Create configuration items to define configurations that you want to manage and assess for compliance on devices.

You can specify the ParentConfigurationItem parameter to create a child configuration item. Child configuration items in System Center 2012 Configuration Manager are copies of configuration items that retain a relationship to the original configuration item; therefore, they inherit the original configuration from the parent configuration item. You cannot create child configuration items for mobile devices.

パラメーター

-Category<String[]>

Specifies an array of localized names of the categories to which the configuration item belongs.

エイリアス

LocalizedCategoryInstanceNames

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-CreationType<CICreationType>

Specifies the type of configuration item. Valid values are:

-- MacOS
-- MobileDevice
-- None
-- WindowsApplication
-- WindowsOS

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Description<String>

Specifies a description for a configuration item.

エイリアス

LocalizedDescription

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Name<String>

Specifies a name for the configuration item.

エイリアス

LocalizedDisplayName

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-ParentConfigurationItem<IResultObject>

Specifies a parent CMConfigurationItem object. To obtain a CMConfigurationItem object, use the Get-CMConfigurationItem cmdlet.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

必須?

false

位置は?

named

既定値

false

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

必須?

false

位置は?

named

既定値

false

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

Example 1: Create a configuration item

This command creates a configuration item for mobile devices named MD_Config88.

PS C:\> New-CMConfigurationItem -CreationType MobileDevice -Name "MD_Config88"

関連トピック

Get-CMConfigurationItem

Set-CMConfigurationItem

Import-CMConfigurationItem

Remove-CMConfigurationItem

Export-CMConfigurationItem