New-CMConfigurationItem
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 の子構成項目は、元の構成項目との関係を保持する構成項目のコピーです。そのため、親構成項目から元の構成を継承します。 モバイル デバイスの子構成項目を作成することはできません。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: 構成項目を作成する
PS XYZ:\> New-CMConfigurationItem -CreationType MobileDevice -Name "MD_Config88"このコマンドは、MD_Config88 という名前のモバイル デバイスの構成項目を作成します。
パラメーター
-Category
構成項目が属するカテゴリのローカライズされた名前の配列を指定します。
| 型: | String[] |
| Aliases: | LocalizedCategoryInstanceNames |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CreationType
構成項目の種類を指定します。 このパラメーターの有効な値は次のとおりです。
- MacOS
- MobileDevice
- なし
- WindowsApplication
- WindowsOS
| 型: | CICreationType |
| 指定可能な値: | None, WindowsApplication, WindowsOS, MacOS, MobileDevice |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Description
構成項目の説明を指定します。
| 型: | String |
| Aliases: | LocalizedDescription |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
構成項目の名前を指定します。
| 型: | String |
| Aliases: | LocalizedDisplayName |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ParentConfigurationItem
親 CMConfigurationItem オブジェクトを指定します。 CMConfigurationItem オブジェクトを取得するには、Get-CMConfigurationItem コマンドレットを使用します。
| 型: | IResultObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
IResultObject