Set-CMSoftwareUpdateGroup

Configuration Manager のソフトウェア更新グループの構成設定を変更します。

構文

Set-CMSoftwareUpdateGroup
   [-AddSoftwareUpdate <IResultObject[]>]
   [-ClearExpiredSoftwareUpdate]
   [-ClearSoftwareUpdate]
   [-ClearSupersededSoftwareUpdate]
   [-Description <String>]
   -Id <Int32>
   [-NewName <String>]
   [-PassThru]
   [-RemoveSoftwareUpdate <IResultObject[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMSoftwareUpdateGroup
   [-AddSoftwareUpdate <IResultObject[]>]
   [-ClearExpiredSoftwareUpdate]
   [-ClearSoftwareUpdate]
   [-ClearSupersededSoftwareUpdate]
   [-Description <String>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-RemoveSoftwareUpdate <IResultObject[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMSoftwareUpdateGroup
   [-AddSoftwareUpdate <IResultObject[]>]
   [-ClearExpiredSoftwareUpdate]
   [-ClearSoftwareUpdate]
   [-ClearSupersededSoftwareUpdate]
   [-Description <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveSoftwareUpdate <IResultObject[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-CMSoftwareUpdateGroup コマンドレットは、1 つ以上の Configuration Manager ソフトウェア更新プログラム グループの名前または説明を変更するか、1 つ以上のセキュリティ スコープのソフトウェア更新グループを追加または削除します。

ソフトウェア更新プログラム グループは、1 つ以上のソフトウェア更新プログラムのコレクションです。 ソフトウェア更新プログラムをソフトウェア更新プログラム グループに追加し、そのグループをクライアントに展開できます。 ソフトウェア更新プログラム グループを展開した後、新しいソフトウェア更新プログラムをグループに追加すると、Configuration Manager によって自動的に展開されます。

注:

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

例 1: ソフトウェア更新プログラム グループをセキュリティ スコープに追加する

PS XYZ:\> Set-CMSoftwareUpdateGroup -SecurityScopeAction AddMembership -SecurityScopeName "ScopeNameD02" -Name "SUGroup01"

このコマンドは、SUGroup01 という名前のソフトウェア更新プログラム グループを ScopeNameD02 という名前のセキュリティ スコープのメンバーとして追加します。

例 2: セキュリティ スコープからソフトウェア更新プログラム グループを削除する

PS XYZ:\> Set-CMSoftwareUpdateGroup -SecurityScopeAction RemoveMembership -SecurityScopeName "ScopeNameD17" -Name "SUGroup01"

このコマンドは、SCOPENameD17 という名前のセキュリティ スコープのメンバーシップから SUGroup01 という名前のソフトウェア更新プログラム グループを削除します。

パラメーター

-AddSoftwareUpdate

型:IResultObject[]
Aliases:AddSoftwareUpdates
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ClearExpiredSoftwareUpdate

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ClearSoftwareUpdate

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ClearSupersededSoftwareUpdate

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る: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

-Id

ソフトウェア更新グループの ID の配列を指定します。

型:Int32
Aliases:CIId, CI_ID
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputObject

ソフトウェア グループ オブジェクトを指定します。 ソフトウェア グループ オブジェクトを取得するには、 Get-CMSoftwareUpdateGroup コマンドレットを使用します。

型:IResultObject
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

ソフトウェア更新グループの名前の配列を指定します。

型:String
Aliases:LocalizedDisplayName
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-NewName

ソフトウェア更新グループの名前を指定します。 この名前は、グループの現在の名前に置き換えられます。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PassThru

このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RemoveSoftwareUpdate

型:IResultObject[]
Aliases:RemoveSoftwareUpdates
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

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

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object