New-AzEventGridSubscription
Crea in modo asincrono una nuova sottoscrizione di eventi o aggiorna una sottoscrizione di eventi esistente in base all'ambito specificato.
Sintassi
New-AzEventGridSubscription
-Name <String>
-Scope <String>
[-DeadLetterWithResourceIdentityType <String>]
[-DeadLetterWithResourceIdentityUserAssignedIdentity <String>]
[-DeliveryWithResourceIdentityDestination <IEventSubscriptionDestination>]
[-DeliveryWithResourceIdentityType <String>]
[-DeliveryWithResourceIdentityUserAssignedIdentity <String>]
[-Destination <IEventSubscriptionDestination>]
[-EventDeliverySchema <String>]
[-ExpirationTimeUtc <DateTime>]
[-FilterAdvancedFilter <IAdvancedFilter[]>]
[-FilterEnableAdvancedFilteringOnArray]
[-FilterIncludedEventType <String[]>]
[-FilterIsSubjectCaseSensitive]
[-FilterSubjectBeginsWith <String>]
[-FilterSubjectEndsWith <String>]
[-Label <String[]>]
[-RetryPolicyEventTimeToLiveInMinute <Int32>]
[-RetryPolicyMaxDeliveryAttempt <Int32>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzEventGridSubscription
-Name <String>
-Scope <String>
-JsonString <String>
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzEventGridSubscription
-Name <String>
-Scope <String>
-JsonFilePath <String>
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzEventGridSubscription
-InputObject <IEventGridIdentity>
[-DeadLetterWithResourceIdentityType <String>]
[-DeadLetterWithResourceIdentityUserAssignedIdentity <String>]
[-DeliveryWithResourceIdentityDestination <IEventSubscriptionDestination>]
[-DeliveryWithResourceIdentityType <String>]
[-DeliveryWithResourceIdentityUserAssignedIdentity <String>]
[-Destination <IEventSubscriptionDestination>]
[-EventDeliverySchema <String>]
[-ExpirationTimeUtc <DateTime>]
[-FilterAdvancedFilter <IAdvancedFilter[]>]
[-FilterEnableAdvancedFilteringOnArray]
[-FilterIncludedEventType <String[]>]
[-FilterIsSubjectCaseSensitive]
[-FilterSubjectBeginsWith <String>]
[-FilterSubjectEndsWith <String>]
[-Label <String[]>]
[-RetryPolicyEventTimeToLiveInMinute <Int32>]
[-RetryPolicyMaxDeliveryAttempt <Int32>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Descrizione
Crea in modo asincrono una nuova sottoscrizione di eventi o aggiorna una sottoscrizione di eventi esistente in base all'ambito specificato.
Esempio
Esempio 1: crea in modo asincrono una nuova sottoscrizione di eventi o aggiorna una sottoscrizione di eventi esistente in base all'ambito specificato.
$obj = New-AzEventGridWebHookEventSubscriptionDestinationObject -EndpointUrl "https://azpsweb.azurewebsites.net/api/updates"
New-AzEventGridSubscription -Name azps-eventsub -Scope "subscriptions/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" -Destination $obj -FilterIsSubjectCaseSensitive:$false
Name ResourceGroupName
---- -----------------
azps-eventsubCrea in modo asincrono una nuova sottoscrizione di eventi o aggiorna una sottoscrizione di eventi esistente in base all'ambito specificato.
Esempio 2: crea in modo asincrono una nuova sottoscrizione di eventi o aggiorna una sottoscrizione di eventi esistente in base all'ambito specificato.
$obj = New-AzEventGridWebHookEventSubscriptionDestinationObject -EndpointUrl "https://azpsweb.azurewebsites.net/api/updates"
$topic = Get-AzEventGridTopic -ResourceGroupName azps_test_group_eventgrid -Name azps-topic
New-AzEventGridSubscription -Name azps-eventsub -Scope $topic.Id -Destination $obj -FilterIsSubjectCaseSensitive:$false -FilterSubjectBeginsWith "ExamplePrefix" -FilterSubjectEndsWith "ExampleSuffix"
Name ResourceGroupName
---- -----------------
azps-eventsub azps_test_group_eventgridCrea in modo asincrono una nuova sottoscrizione di eventi o aggiorna una sottoscrizione di eventi esistente in base all'ambito specificato.
Parametri
-AsJob
Eseguire il comando come processo
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Confirm
Richiede conferma prima di eseguire il cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DeadLetterWithResourceIdentityType
Tipo di identità gestita usata. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'Nessuno' rimuoverà qualsiasi identità.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DeadLetterWithResourceIdentityUserAssignedIdentity
Identità utente associata alla risorsa.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DefaultProfile
Il parametro DefaultProfile non è funzionale. Usare il parametro SubscriptionId quando disponibile se si esegue il cmdlet su una sottoscrizione diversa.
| Tipo: | PSObject |
| Alias: | AzureRMContext, AzureCredential |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DeliveryWithResourceIdentityDestination
Informazioni sulla destinazione in cui devono essere recapitati gli eventi per la sottoscrizione di eventi. Usa l'identità di Griglia di eventi di Azure per acquisire i token di autenticazione usati durante il recapito o l'invio di messaggi non recapitabili.
| Tipo: | IEventSubscriptionDestination |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DeliveryWithResourceIdentityType
Tipo di identità gestita usata. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'Nessuno' rimuoverà qualsiasi identità.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-DeliveryWithResourceIdentityUserAssignedIdentity
Identità utente associata alla risorsa.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Destination
Informazioni sulla destinazione in cui devono essere recapitati gli eventi per la sottoscrizione di eventi. Usa l'identità di Griglia di eventi di Azure per acquisire i token di autenticazione usati durante il recapito o l'invio di messaggi non recapitabili.
| Tipo: | IEventSubscriptionDestination |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-EventDeliverySchema
Schema di recapito degli eventi per la sottoscrizione di eventi.
| Tipo: | String |
| Alias: | DeliverySchema |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ExpirationTimeUtc
Scadenza della sottoscrizione di eventi.
| Tipo: | DateTime |
| Alias: | ExpirationDate |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-FilterAdvancedFilter
Matrice di filtri avanzati usati per filtrare le sottoscrizioni di eventi.
| Tipo: | IAdvancedFilter[] |
| Alias: | AdvancedFilter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-FilterEnableAdvancedFilteringOnArray
Consente di valutare i filtri avanzati rispetto a una matrice di valori anziché prevedere un valore singolare.
| Tipo: | SwitchParameter |
| Alias: | AdvancedFilteringOnArray |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-FilterIncludedEventType
Elenco dei tipi di evento applicabili che devono far parte della sottoscrizione di eventi. Se si desidera sottoscrivere tutti i tipi di evento predefiniti, impostare IncludedEventTypes su null.
| Tipo: | String[] |
| Alias: | IncludedEventType |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-FilterIsSubjectCaseSensitive
Specifica se le proprietà SubjectBeginsWith e SubjectEndsWith dei filtri devono essere confrontate in modo con distinzione tra maiuscole e minuscole.
| Tipo: | SwitchParameter |
| Alias: | SubjectCaseSensitive |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-FilterSubjectBeginsWith
Stringa facoltativa per filtrare gli eventi per una sottoscrizione di eventi in base al prefisso di un percorso della risorsa. Il formato di questo dipende dall'autore degli eventi. I caratteri jolly non sono supportati in questo percorso.
| Tipo: | String |
| Alias: | SubjectBeginsWith |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-FilterSubjectEndsWith
Stringa facoltativa per filtrare gli eventi per una sottoscrizione di eventi in base al suffisso del percorso della risorsa. I caratteri jolly non sono supportati in questo percorso.
| Tipo: | String |
| Alias: | SubjectEndsWith |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-InputObject
Parametro Identity
| Tipo: | IEventGridIdentity |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-JsonFilePath
Percorso del file JSON fornito all'operazione di creazione
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-JsonString
Stringa JSON fornita all'operazione di creazione
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Label
Elenco di etichette definite dall'utente.
| Tipo: | String[] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Name
Nome della sottoscrizione di eventi. I nomi delle sottoscrizioni di eventi devono avere una lunghezza compresa tra 3 e 64 caratteri e devono usare solo lettere alfanumerici.
| Tipo: | String |
| Alias: | EventSubscriptionName |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-NoWait
Eseguire il comando in modo asincrono
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-PassThru
Restituisce true quando il comando ha esito positivo
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-RetryPolicyEventTimeToLiveInMinute
Durata (in minuti) per gli eventi.
| Tipo: | Int32 |
| Alias: | EventTtl |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-RetryPolicyMaxDeliveryAttempt
Numero massimo di tentativi di recapito per gli eventi.
| Tipo: | Int32 |
| Alias: | MaxDeliveryAttempt |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Scope
Identificatore della risorsa a cui deve essere creata o aggiornata la sottoscrizione di eventi. L'ambito può essere una sottoscrizione, un gruppo di risorse o una risorsa di primo livello appartenente a uno spazio dei nomi del provider di risorse o un argomento EventGrid. Ad esempio, usare '/subscriptions/{subscriptionId}/' per una sottoscrizione, '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' per un gruppo di risorse, e '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}' per una risorsa e '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/topics/{topicName}' per un argomento EventGrid.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-WhatIf
Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
Input
Output
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per