Set-CMConfigurationItem

  • リファレンス
モジュール:
ConfigurationManager

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:\> 。 詳細については 、「Getting started」を参照してください。

例

例 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
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
-Description

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

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

構成アイテムを含むダイジェストを指定します。

Type:ConfigurationItem
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DigestPath

ダイジェストのパスを指定します。

Type:String
Aliases:DesiredConfigurationDigestPath
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DigestXml

XML 定義を指定します。

Type:String
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
-Id

1 つ以上の構成項目の識別子の配列を指定します。 コンマ区切りリストを使用できます。

Type:Int32
Aliases:CIId, CI_ID
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-InputObject

構成アイテム オブジェクトを指定します。 構成アイテム オブジェクトを取得するには 、Get-CMConfigurationItem コマンドレットを使用 できます。

Type:IResultObject
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-Name

構成項目の名前の配列を指定します。

Type:String
Aliases:LocalizedDisplayName
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NewName

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PassThru

現在の作業オブジェクトを返します。 既定では、このコマンドレットによる出力はありません。

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

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

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
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

出力

System.Object