Dela via

New-AzEventGridDomain

  • Referens
Modul:
Az.EventGrid

Skapar eller uppdaterar asynkront en ny domän med de angivna parametrarna.

Syntax

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

Description

Skapar eller uppdaterar asynkront en ny domän med de angivna parametrarna.

Exempel

Exempel 1: Asynkront Skapa en ny domän med de angivna parametrarna.

$inboundIpRule = New-AzEventGridInboundIPRuleObject -Action Allow -IPMask "12.18.176.1"
New-AzEventGridDomain -Name azps-domain -ResourceGroupName azps_test_group_eventgrid -Location westus2 -PublicNetworkAccess Enabled -InboundIPRule $inboundIpRule

Location Name        ResourceGroupName
-------- ----        -----------------
westus2  azps-domain azps_test_group_eventgrid

Asynkront Skapa en ny domän med de angivna parametrarna.

Parametrar

-AsJob

Kör kommandot som ett jobb

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AutoCreateTopicWithFirstSubscription

Det här booleska används för att ange skapandemekanismen för "alla" Event Grid-domänämnen som är associerade med den här Event Grid-domänresursen. I det här sammanhanget kan skapandet av domänämnet hanteras automatiskt (när det är sant) eller självhanterat (när det är falskt). Standardvärdet för den här egenskapen är sant. När den här egenskapen är null eller inställd på true ansvarar Event Grid för att automatiskt skapa domänämnet när den första händelseprenumerationen skapas i domänämnets omfång. Om den här egenskapen är inställd på false kräver skapandet av den första händelseprenumerationen att användaren skapar ett domänämne. Självhanteringsläget kan användas om användaren vill ha fullständig kontroll över när domänämnet skapas, medan automatiskt hanterat läge ger flexibiliteten att utföra mindre åtgärder och hantera färre resurser av användaren. Observera också att i läget för automatisk hanterad skapande kan användaren skapa ämnetdomain på begäran om det behövs.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-AutoDeleteTopicWithLastSubscription

Den här booleska används för att ange borttagningsmekanismen för "alla" Event Grid-domänämnen som är associerade med den här Event Grid-domänresursen. I det här sammanhanget kan borttagning av domänämne hanteras automatiskt (när det är sant) eller självhanterat (när det är falskt). Standardvärdet för den här egenskapen är sant. När den här egenskapen är inställd på true ansvarar Event Grid för att automatiskt ta bort domänämnet när den senaste händelseprenumerationen i domänämnets omfång tas bort. Om den här egenskapen är inställd på false måste användaren manuellt ta bort domänämnet när det inte längre behövs (t.ex. när den senaste händelseprenumerationen tas bort och resursen måste rensas). Självhanteringsläget kan användas om användaren vill ha fullständig kontroll över när domänämnet måste tas bort, medan automatiskt hanterat läge ger flexibiliteten att utföra mindre åtgärder och hantera färre resurser av användaren.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DataResidencyBoundary

Dataplaceringsgräns för resursen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Parametern DefaultProfile fungerar inte. Använd parametern SubscriptionId när den är tillgänglig om du kör cmdleten mot en annan prenumeration.

Typ:PSObject
Alias:AzureRMContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DisableLocalAuth

Det här booleska värdet används för att aktivera eller inaktivera lokal autentisering. Standardvärdet är falskt. När egenskapen är inställd på true används endast AAD-token för att autentisera om användaren tillåts publicera till domänen.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-EnableSystemAssignedIdentity

Avgör om du aktiverar en systemtilldelad identitet för resursen.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-EventTypeInfoInlineEventType

En samling infogade händelsetyper för resursen. De infogade händelsetypsnycklarna är av typen sträng som representerar namnet på händelsen. Ett exempel på ett giltigt infogat händelsenamn är "Contoso.OrderCreated". Värdena för den infogade händelsetypen är av typen InlineEventProperties och innehåller ytterligare information för varje infogad händelsetyp.

Typ:Hashtable
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-EventTypeInfoKind

Den typ av händelsetyp som används.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-IdentityPrincipalId

Huvud-ID för resursidentitet.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-IdentityTenantId

Resursens klientorganisations-ID.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InboundIPRule

Detta kan användas för att begränsa trafik från specifika IP-adresser i stället för alla IP-adresser. Obs! Dessa betraktas endast om PublicNetworkAccess är aktiverat.

Typ:IInboundIPRule[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InputObject

Identitetsparameter

Typ:IEventGridIdentity
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-InputSchema

Detta avgör vilket format Event Grid ska förvänta sig för inkommande händelser som publicerats till Event Grid-domänresursen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-JsonFilePath

Sökväg till Json-fil som angetts för åtgärden Skapa

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-JsonString

Json-sträng som har angetts för åtgärden Skapa

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Location

Resursens plats.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MinimumTlsVersionAllowed

Lägsta TLS-version av utgivaren som tillåts publicera till den här domänen

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Namnet på domänen.

Typ:String
Alias:DomainName
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-NoWait

Kör kommandot asynkront

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PassThru

Returnerar sant när kommandot lyckas

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PublicNetworkAccess

Detta avgör om trafik tillåts via offentligt nätverk. Som standard är den aktiverad. Du kan ytterligare begränsa till specifika IP-adresser genom att <konfigurera seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.DomainProperties.InboundIpRules" />

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ResourceGroupName

Namnet på resursgruppen i användarens prenumeration.

Typ:String
Alias:ResourceGroup
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SkuName

Resursens SKU-namn. Möjliga värden är: Basic eller Premium.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SubscriptionId

Prenumerationsautentiseringsuppgifter som unikt identifierar en Microsoft Azure-prenumeration. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop.

Typ:String
Position:Named
Standardvärde:(Get-AzContext).Subscription.Id
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Tag

Taggar för resursen.

Typ:Hashtable
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-UserAssignedIdentity

Matrisen med användartilldelade identiteter som är associerade med resursen. Elementen i matrisen är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.'

Typ:String[]
Alias:IdentityId
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

IEventGridIdentity

Utdata

IDomain