Freigeben über


New-AzEventGridTopic

Erstellt asynchron ein neues Thema mit den angegebenen Parametern.

Syntax

New-AzEventGridTopic
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   [-DataResidencyBoundary <String>]
   [-DisableLocalAuth]
   [-EnableSystemAssignedIdentity]
   [-EventTypeInfoInlineEventType <Hashtable>]
   [-EventTypeInfoKind <String>]
   [-ExtendedLocationName <String>]
   [-ExtendedLocationType <String>]
   [-IdentityPrincipalId <String>]
   [-IdentityTenantId <String>]
   [-InboundIPRule <IInboundIPRule[]>]
   [-InputSchema <String>]
   [-Kind <String>]
   [-MinimumTlsVersionAllowed <String>]
   [-PublicNetworkAccess <String>]
   [-SkuName <String>]
   [-Tag <Hashtable>]
   [-UserAssignedIdentity <String[]>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzEventGridTopic
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -JsonString <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzEventGridTopic
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -JsonFilePath <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzEventGridTopic
   -InputObject <IEventGridIdentity>
   -Location <String>
   [-DataResidencyBoundary <String>]
   [-DisableLocalAuth]
   [-EnableSystemAssignedIdentity]
   [-EventTypeInfoInlineEventType <Hashtable>]
   [-EventTypeInfoKind <String>]
   [-ExtendedLocationName <String>]
   [-ExtendedLocationType <String>]
   [-IdentityPrincipalId <String>]
   [-IdentityTenantId <String>]
   [-InboundIPRule <IInboundIPRule[]>]
   [-InputSchema <String>]
   [-Kind <String>]
   [-MinimumTlsVersionAllowed <String>]
   [-PublicNetworkAccess <String>]
   [-SkuName <String>]
   [-Tag <Hashtable>]
   [-UserAssignedIdentity <String[]>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Erstellt asynchron ein neues Thema mit den angegebenen Parametern.

Beispiele

Beispiel 1: Erstellt asynchron ein neues Thema mit den angegebenen Parametern.

$inboundIpRule = New-AzEventGridInboundIPRuleObject -Action Allow -IPMask "12.18.176.1"
New-AzEventGridTopic -Name azps-topic -ResourceGroupName azps_test_group_eventgrid -Location eastus -PublicNetworkAccess Enabled -InboundIPRule $inboundIpRule

Location Name       Kind  ResourceGroupName
-------- ----       ----  -----------------
eastus   azps-topic Azure azps_test_group_eventgrid

Erstellt asynchron ein neues Thema mit den angegebenen Parametern.

Parameter

-AsJob

Ausführen des Befehls als Auftrag

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliases:cf
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-DataResidencyBoundary

Data Residency-Grenze der Ressource.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Der Parameter DefaultProfile ist nicht funktionsfähig. Verwenden Sie den Parameter "SubscriptionId", wenn sie verfügbar ist, wenn Sie das Cmdlet für ein anderes Abonnement ausführen.

Typ:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableLocalAuth

Dieser boolesche Wert wird verwendet, um die lokale Authentifizierung zu aktivieren oder zu deaktivieren. Der Standardwert ist "false". Wenn die Eigenschaft auf "true" festgelegt ist, wird nur ein AAD-Token verwendet, um sich zu authentifizieren, wenn der Benutzer im Thema veröffentlichen darf.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableSystemAssignedIdentity

Entscheidet, ob eine vom System zugewiesene Identität für die Ressource aktiviert wird.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-EventTypeInfoInlineEventType

Eine Auflistung von Inlineereignistypen für die Ressource. Die Inlineereignistypschlüssel sind vom Typ Zeichenfolge, die den Namen des Ereignisses darstellt. Ein Beispiel für einen gültigen Inlineereignisnamen ist "Contoso.OrderCreated". Die Inlineereignistypwerte sind vom Typ "InlineEventProperties" und enthalten zusätzliche Informationen für jeden Inlineereignistyp.

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-EventTypeInfoKind

Die Art des verwendeten Ereignistyps.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-ExtendedLocationName

Vollqualifizierter Name des erweiterten Speicherorts.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-ExtendedLocationType

Typ des erweiterten Speicherorts.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-IdentityPrincipalId

Die Prinzipal-ID der Ressourcenidentität.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-IdentityTenantId

Die Mandanten-ID der Ressource.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-InboundIPRule

Dies kann verwendet werden, um den Datenverkehr von bestimmten IPs anstelle aller IPs einzuschränken. Hinweis: Diese werden nur berücksichtigt, wenn PublicNetworkAccess aktiviert ist.

Typ:IInboundIPRule[]
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Identity-Parameter

Typ:IEventGridIdentity
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:True
Accept wildcard characters:False

-InputSchema

Dadurch wird das Format bestimmt, das das Ereignisraster für eingehende Ereignisse erwarten soll, die im Thema veröffentlicht wurden.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-JsonFilePath

Pfad der JSON-Datei, die für den Erstellungsvorgang bereitgestellt wird

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-JsonString

Json-Zeichenfolge, die für den Create-Vorgang bereitgestellt wird

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-Kind

Art der Ressource.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

Speicherort der Ressource.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-MinimumTlsVersionAllowed

Minimale TLS-Version des Herausgebers, die in diesem Thema veröffentlicht werden darf

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Name des Themas.

Typ:String
Aliases:TopicName
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-NoWait

Asynchrones Ausführen des Befehls

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Gibt true zurück, wenn der Befehl erfolgreich ist.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicNetworkAccess

Dadurch wird ermittelt, ob Datenverkehr über das öffentliche Netzwerk zulässig ist. Standardmäßig ist sie aktiviert. Sie können weiter auf bestimmte IPs einschränken, indem <Sie seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" />

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Der Name der Ressourcengruppe innerhalb des Abonnements des Benutzers.

Typ:String
Aliases:ResourceGroup
Position:Named
Standardwert:None
Erforderlich:True
Accept pipeline input:False
Accept wildcard characters:False

-SkuName

Der Sku-Name der Ressource. Mögliche Werte sind: Basic oder Premium.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

Abonnementanmeldeinformationen, die ein Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.

Typ:String
Position:Named
Standardwert:(Get-AzContext).Subscription.Id
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

Tags der Ressource.

Typ:Hashtable
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-UserAssignedIdentity

Das Array der benutzer zugewiesenen Identitäten, die der Ressource zugeordnet sind. Die Elemente im Array sind ARM-Ressourcen-IDs in der Form: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

Typ:String[]
Aliases:IdentityId
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliases:wi
Position:Named
Standardwert:None
Erforderlich:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

IEventGridIdentity

Ausgaben

ITopic