New-CMConfigurationItem

リファレンス

モジュール:: ConfigurationManager

Configuration Manager 構成アイテムを作成します。

構文

New-CMConfigurationItem
   [-Category <String[]>]
   [-Description <String>]
   -Name <String>
   -ParentConfigurationItem <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-CMConfigurationItem
   [-Category <String[]>]
   -CreationType <CICreationType>
   [-Description <String>]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

New-CMConfigurationItem コマンドレットは、Configuration Manager に構成アイテムを作成します。デバイスのコンプライアンスを管理および評価する構成を定義する構成項目を作成します。

ParentConfigurationItem パラメーターを指定して、子構成アイテムを作成できます。 Configuration Manager の子構成アイテムは、元の構成アイテムとの関係を保持する構成アイテムのコピーです。したがって、親構成アイテムから元の構成を継承します。モバイルデバイスの子構成アイテムを作成することはできません。

注意

Configuration Manager サイトドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。詳細については、「Getting started」を参照してください。

例

例 1: 構成アイテムを作成する

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

このコマンドは、モバイルデバイスの構成アイテムを MD_Config88。

パラメーター

-Category

構成アイテムが属するカテゴリのローカライズされた名前の配列を指定します。

Type:	String[]
Aliases:	LocalizedCategoryInstanceNames
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CreationType

構成項目の種類を指定します。このパラメーターの有効な値は次のとおりです。

MacOS
MobileDevice
なし
WindowsApplication
WindowsOS

Type:	CICreationType
Accepted values:	None, WindowsApplication, WindowsOS, MacOS, MobileDevice
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

構成アイテムの説明を指定します。

Type:	String
Aliases:	LocalizedDescription
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

構成アイテムの名前を指定します。

Type:	String
Aliases:	LocalizedDisplayName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ParentConfigurationItem

親 CMConfigurationItem オブジェクトを指定 します。 CMConfigurationItemオブジェクトを取得するには、Get-CMConfigurationItem コマンドレットを使用します。

Type:	IResultObject
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。コマンドレットは実行されません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject