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 を変更できます。 指定したセキュリティ スコープにアラート サブスクリプションを追加するか、指定したセキュリティ スコープから削除することで、アラート サブスクリプションのセキュリティ スコープ メンバーシップを変更できます。

注意

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

例

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

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

このコマンドは、ID が割り当Windowsサブスクリプションの名前、電子メール アドレス、ロケール ID、およびアラート ID を16777217。

例 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
Type:String[]
Aliases:AddEmailAddresses
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-AlertId

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

Type:Int32[]
Aliases:AlertIds
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
-DisableWildcardHandling

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

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

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

Type:String[]
Aliases:EmailAddresses
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

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

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

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

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
-LocaleId

警告メッセージのロケールを指定します。 ロケール識別子の詳細と一覧については、「 付録 A: Product Behavior」を参照してください。

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Name

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

Type:String
Position:Named
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
-RemoveEmailAddress
Type:String[]
Aliases:RemoveEmailAddresses
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