Condividi tramite


Set-CMAlertSubscription

Modifica le proprietà di una sottoscrizione di avviso.

Sintassi

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>]

Descrizione

Il cmdlet Set-CMAlertSubscription modifica le proprietà di un oggetto sottoscrizione di avviso in Configuration Manager. È possibile modificare il nome di una sottoscrizione di avviso, l'indirizzo di posta elettronica del destinatario di una notifica di avviso, l'ID impostazioni locali di Windows e l'ID avviso. È anche possibile modificare l'appartenenza all'ambito di sicurezza di una sottoscrizione di avviso aggiungendola o rimuovendola da un ambito di sicurezza specificato.

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Modificare le proprietà di una sottoscrizione di avviso in base all'ID sottoscrizione

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

Questo comando modifica il nome, l'indirizzo di posta elettronica, l'ID impostazioni locali di Windows e l'ID avviso di una sottoscrizione di avviso con ID 16777217.

Esempio 2: Modificare le proprietà di una sottoscrizione di avviso in base al nome della sottoscrizione

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

Questo comando modifica il nome, l'indirizzo di posta elettronica, l'ID impostazioni locali di Windows e l'ID avviso di una sottoscrizione di avviso denominata Subscription01.

Esempio 3: Modificare le proprietà di una sottoscrizione di avviso usando l'output di un altro cmdlet come input

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

Il primo comando ottiene un oggetto sottoscrizione di avviso con l'ID 16777310 e quindi archivia l'oggetto nella variabile $SubObj.

Il secondo comando modifica le proprietà dell'oggetto sottoscrizione di avviso, che includono il nome della sottoscrizione, il destinatario della posta elettronica, l'ID impostazioni locali e l'ID avviso, per la notifica di avviso archiviata nella variabile $SubObj.

Esempio 4: Aggiungere una sottoscrizione di avviso a un ambito di sicurezza

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

Questo comando aggiunge la sottoscrizione di avviso denominata Subscription01 all'ambito di sicurezza denominato Test.

Esempio 5: Rimuovere una sottoscrizione di avviso da un ambito di sicurezza

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

Questo comando rimuove la sottoscrizione di avviso denominata Subscription01 dall'ambito di sicurezza denominato Test.

Parametri

-AddEmailAddress

Tipo:String[]
Alias:AddEmailAddresses
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-AlertId

Specifica una matrice di ID avviso per le sottoscrizioni.

Tipo:Int32[]
Alias:AlertIds
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EmailAddress

Specifica un indirizzo di posta elettronica in cui si vuole inviare una notifica di avviso. È possibile separare più indirizzi di posta elettronica usando un punto e virgola.

Tipo:String[]
Alias:EmailAddresses
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

Specifica l'identificatore per un oggetto sottoscrizione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specifica un oggetto notifica di avviso in Configuration Manager.

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-LocaleId

Specifica le impostazioni locali per i messaggi di avviso. Per altre informazioni e un elenco degli identificatori delle impostazioni locali, vedere Appendice A: Comportamento del prodotto.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica il nome di un oggetto sottoscrizione di avviso.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NewName

Specifica un nuovo nome per un oggetto sottoscrizione di avviso.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RemoveEmailAddress

Tipo:String[]
Alias:RemoveEmailAddresses
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object