Set-CMConfigurationItem
Configuration Manager構成項目の設定を変更します。
構文
Set-CMConfigurationItem
[-AddCategory <String[]>]
[-Description <String>]
[-Digest <ConfigurationItem>]
[-DigestPath <String>]
[-DigestXml <String>]
[-Id] <Int32>
[-NewName <String>]
[-PassThru]
[-RemoveCategory <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMConfigurationItem
[-AddCategory <String[]>]
[-Description <String>]
[-Digest <ConfigurationItem>]
[-DigestPath <String>]
[-DigestXml <String>]
[-Name] <String>
[-NewName <String>]
[-PassThru]
[-RemoveCategory <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMConfigurationItem
[-AddCategory <String[]>]
[-Description <String>]
[-Digest <ConfigurationItem>]
[-DigestPath <String>]
[-DigestXml <String>]
[-InputObject] <IResultObject>
[-NewName <String>]
[-PassThru]
[-RemoveCategory <String[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
Set-CMConfigurationItem コマンドレットは、Configuration Manager構成項目の設定を変更します。
構成項目には、コンプライアンス規則と共に 1 つ以上の設定が含まれています。 項目は通常、監視する構成の単位を定義します。 構成項目の詳細については、「Configuration Managerのコンプライアンス設定の概要」を参照してください。
注:
Configuration Manager サイト ドライブからConfiguration Managerコマンドレットを実行します (例: PS XYZ:\>)。 詳細については、「作業の 開始」を参照してください。
例
例 1: 構成項目の名前を変更する
PS XYZ:\> Set-CMConfigurationItem -Name "CITest" -NewName "CITest01"このコマンドは、CITest という名前の構成項目の名前を CITest01 に変更します。
例 2: 項目の設定を設定する
PS XYZ:\> Set-CMConfigurationItem -Name "CITest01" -SecurityScopeAction AddMembership -SecurityScopeName "DefaultScope"このコマンドは、セキュリティ スコープ アクションを AddMembership に設定し、セキュリティ スコープ名を CITest01 という名前の項目の DefaultScope に設定します。
例 3: 項目の設定を変更する
PS XYZ:\> Set-CMConfigurationItem -Name "CITest01" -SecurityScopeAction RemoveMembership -SecurityScopeName "DefaultScope"このコマンドは、セキュリティ スコープ アクションを RemoveMembership に設定し、セキュリティ スコープ名を CITest01 という名前の項目の DefaultScope に設定します。
パラメーター
-AddCategory
構成項目が属するカテゴリのローカライズされた名前の配列を指定します。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
構成項目の説明を指定します。
| Type: | String |
| Aliases: | LocalizedDescription |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Digest
構成項目を含むダイジェストを指定します。
| Type: | ConfigurationItem |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DigestPath
ダイジェストのパスを指定します。
| Type: | String |
| Aliases: | DesiredConfigurationDigestPath |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DigestXml
XML 定義を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Id
1 つ以上の構成項目の識別子の配列を指定します。 コンマ区切りリストを使用できます。
| Type: | Int32 |
| Aliases: | CIId, CI_ID |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
構成項目オブジェクトを指定します。 構成項目オブジェクトを取得するには、 Get-CMConfigurationItem コマンドレットを使用します。
| Type: | IResultObject |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
構成項目の名前の配列を指定します。
| Type: | String |
| Aliases: | LocalizedDisplayName |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NewName
構成項目の新しい名前を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
現在の作業オブジェクトを返します。 既定では、このコマンドレットによる出力はありません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveCategory
構成項目を削除するカテゴリのローカライズされた名前の配列を指定します。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object
関連リンク
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示