Set-CMAlertSubscription

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

アラート サブスクリプションのプロパティを変更します。

構文

Set-CMAlertSubscription
   [-AddEmailAddress <String[]>]
   [-AlertId <Int32[]>]
   [-EmailAddress <String[]>]
   -InputObject <IResultObject>
   [-LocaleId <Int32>]
   [-NewName <String>]
   [-PassThru]
   [-RemoveEmailAddress <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMAlertSubscription
   [-AddEmailAddress <String[]>]
   [-AlertId <Int32[]>]
   [-EmailAddress <String[]>]
   -Id <String>
   [-LocaleId <Int32>]
   [-NewName <String>]
   [-PassThru]
   [-RemoveEmailAddress <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMAlertSubscription
   [-AddEmailAddress <String[]>]
   [-AlertId <Int32[]>]
   [-EmailAddress <String[]>]
   [-LocaleId <Int32>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveEmailAddress <String[]>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-CMAlertSubscription コマンドレットは、Configuration Manager のアラート サブスクリプション オブジェクトのプロパティを変更します。 アラート サブスクリプションの名前、アラート通知の受信者のメール アドレス、Windows ロケール ID、およびアラート ID を変更できます。 また、指定したセキュリティ スコープに追加するか、指定したセキュリティ スコープから削除することで、アラート サブスクリプションのセキュリティ スコープ メンバーシップを変更することもできます。

注:

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

例

例 1: サブスクリプション ID でアラート サブスクリプションのプロパティを変更する

PS XYZ:\> Set-CMAlertSubscription -Id "16777217" -NewName "Subscription02" -EmailAddress "evan.narvaez@contoso.com" -LocaleId 2057 -AlertIds 16777240

このコマンドは、ID が16777217されたアラート サブスクリプションの名前、電子メール アドレス、Windows ロケール ID、およびアラート ID を変更します。

例 2: アラート サブスクリプションのプロパティをサブスクリプション名で変更する

PS XYZ:\> Set-CMAlertSubscription -Name "Subscription01" -NewName "Subscription02" -EmailAddress "elisa.daugherty@contoso.com" -LocaleId 2057 -AlertIds 16777240

このコマンドは、Subscription01 という名前のアラート サブスクリプションの名前、電子メール アドレス、Windows ロケール ID、およびアラート ID を変更します。

例 3: 別のコマンドレットからの出力を入力として使用して、アラート サブスクリプションのプロパティを変更する

PS XYZ:\> $SubObj = Get-CMAlertSubscription -Id "16777310"
PS XYZ:\> Set-CMAlertSubscription -AlertSubscription $SubObj -NewName "Subscription02" -EmailAddress "patti.fuller@contoso.com" -LocaleId 3081 -AlertIds 16777240

最初のコマンドは、ID 16777310を持つアラート サブスクリプション オブジェクトを取得し、そのオブジェクトを $SubObj 変数に格納します。

2 番目のコマンドは、$SubObj 変数に格納されているアラート通知のサブスクリプション名、電子メール受信者、ロケール ID、アラート ID を含むアラート サブスクリプション オブジェクトのプロパティを変更します。

例 4: セキュリティ スコープにアラート サブスクリプションを追加する

PS XYZ:\> Set-CMAlertSubscription -SecurityScopeAction AddMembership -SecurityScopeName "Test" -Name "Subscription01"

このコマンドは、Subscription01 という名前のアラート サブスクリプションを Test という名前のセキュリティ スコープに追加します。

例 5: セキュリティ スコープからアラート サブスクリプションを削除する

PS XYZ:\> Set-CMAlertSubscription -SecurityScopeAction RemoveMembership -SecurityScopeName "Test" -Name "Subscription01"

このコマンドは、Subscription01 という名前のアラート サブスクリプションを Test という名前のセキュリティ スコープから削除します。

パラメーター

-AddEmailAddress

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

-AlertId

サブスクリプションのアラート ID の配列を指定します。

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

-Confirm

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

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

-DisableWildcardHandling

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

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

-EmailAddress

アラート通知を送信する電子メール アドレスを指定します。 セミコロンを使用して、複数のメール アドレスを区切ることができます。

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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

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

-Id

サブスクリプション オブジェクトの識別子を指定します。

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

-InputObject

Configuration Manager でアラート通知オブジェクトを指定します。

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

-LocaleId

アラート メッセージのロケールを指定します。 ロケール識別子の詳細と一覧については、「 付録 A: 製品の動作」を参照してください。

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

-Name

アラート サブスクリプション オブジェクトの名前を指定します。

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

-NewName

アラート サブスクリプション オブジェクトの新しい名前を指定します。

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

-PassThru

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

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

-RemoveEmailAddress

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

-WhatIf

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object