Udostępnij za pośrednictwem


New-AzEventGridDomain

Asynchronicznie utwórz nową domenę z określonymi parametrami.

Składnia

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

Opis

Asynchronicznie utwórz nową domenę z określonymi parametrami.

Przykłady

Przykład 1: Asynchronicznie utwórz nową domenę z określonymi parametrami.

$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

Asynchronicznie utwórz nową domenę z określonymi parametrami.

Parametry

-AsJob

Uruchamianie polecenia jako zadania

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-AutoCreateTopicWithFirstSubscription

Ta wartość logiczna służy do określania mechanizmu tworzenia dla "wszystkich" tematów domeny usługi Event Grid skojarzonych z tym zasobem domeny usługi Event Grid. W tym kontekście tworzenie tematu domeny może być zarządzane automatycznie (w przypadku wartości true) lub samodzielnego zarządzania (gdy jest to fałsz). Wartość domyślna tej właściwości to true. Jeśli ta właściwość ma wartość null lub jest ustawiona na wartość true, usługa Event Grid jest odpowiedzialna za automatyczne tworzenie tematu domeny, gdy pierwsza subskrypcja zdarzeń zostanie utworzona w zakresie tematu domeny. Jeśli ta właściwość ma wartość false, utworzenie pierwszej subskrypcji zdarzeń będzie wymagać utworzenia tematu domeny przez użytkownika. Tryb samodzielnego zarządzania może być używany, jeśli użytkownik chce mieć pełną kontrolę nad utworzeniem tematu domeny, a tryb automatycznego zarządzania zapewnia elastyczność wykonywania mniejszej liczby operacji i zarządzania mniejszą liczbą zasobów przez użytkownika. Należy również pamiętać, że w trybie tworzenia automatycznego zarządzanego użytkownik może w razie potrzeby utworzyć temat domeny na żądanie.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-AutoDeleteTopicWithLastSubscription

Ta wartość logiczna służy do określania mechanizmu usuwania dla "wszystkich" tematów domeny usługi Event Grid skojarzonych z tym zasobem domeny usługi Event Grid. W tym kontekście usunięcie tematu domeny może być zarządzane automatycznie (w przypadku wartości true) lub samodzielnego zarządzania (gdy jest to fałsz). Wartość domyślna tej właściwości to true. Gdy ta właściwość ma wartość true, usługa Event Grid jest odpowiedzialna za automatyczne usuwanie tematu domeny po usunięciu ostatniej subskrypcji zdarzeń w zakresie tematu domeny. Jeśli ta właściwość ma wartość false, użytkownik musi ręcznie usunąć temat domeny, gdy nie jest już potrzebny (np. gdy ostatnia subskrypcja zdarzeń zostanie usunięta, a zasób musi zostać wyczyszczony). Tryb samodzielnego zarządzania może być używany, jeśli użytkownik chce mieć pełną kontrola czasu usunięcia tematu domeny, a tryb automatycznego zarządzania zapewnia elastyczność wykonywania mniejszej liczby operacji i zarządzania mniejszą liczbą zasobów przez użytkownika.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DataResidencyBoundary

Granica rezydencji danych zasobu.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Parametr DefaultProfile nie działa. Użyj parametru SubscriptionId, jeśli jest dostępny, jeśli wykonuje polecenie cmdlet dla innej subskrypcji.

Typ:PSObject
Aliasy:AzureRMContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DisableLocalAuth

Ta wartość logiczna służy do włączania lub wyłączania uwierzytelniania lokalnego. Wartość domyślna to false. Gdy właściwość jest ustawiona na true, tylko token usługi AAD będzie używany do uwierzytelniania, jeśli użytkownik może publikować w domenie.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EnableSystemAssignedIdentity

Decyduje o włączeniu tożsamości przypisanej przez system dla zasobu.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EventTypeInfoInlineEventType

Kolekcja wbudowanych typów zdarzeń dla zasobu. Wbudowane klucze typu zdarzenia są ciągiem typu, który reprezentuje nazwę zdarzenia. Przykładem prawidłowej wbudowanej nazwy zdarzenia jest "Contoso.OrderCreated". Wbudowane wartości typu zdarzenia są typu InlineEventProperties i będą zawierać dodatkowe informacje dla każdego typu zdarzenia wbudowanego.

Typ:Hashtable
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-EventTypeInfoKind

Rodzaj używanego typu zdarzenia.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IdentityPrincipalId

Identyfikator podmiotu zabezpieczeń tożsamości zasobu.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-IdentityTenantId

Identyfikator dzierżawy zasobu.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InboundIPRule

Może to służyć do ograniczania ruchu z określonych adresów IP zamiast wszystkich adresów IP. Uwaga: Są one traktowane tylko wtedy, gdy funkcja PublicNetworkAccess jest włączona.

Typ:IInboundIPRule[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InputObject

Parametr tożsamości

Typ:IEventGridIdentity
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-InputSchema

Określa format, którego usługa Event Grid powinna oczekiwać dla zdarzeń przychodzących opublikowanych w zasobie domeny usługi Event Grid.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-JsonFilePath

Ścieżka pliku Json dostarczonego do operacji Tworzenia

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-JsonString

Ciąg Json dostarczony do operacji Tworzenia

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Location

Lokalizacja zasobu.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MinimumTlsVersionAllowed

Minimalna wersja protokołu TLS wydawcy dozwolona do opublikowania w tej domenie

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Nazwa domeny.

Typ:String
Aliasy:DomainName
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-NoWait

Uruchom polecenie asynchronicznie

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PassThru

Zwraca wartość true, gdy polecenie powiedzie się

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PublicNetworkAccess

Określa, czy ruch jest dozwolony za pośrednictwem sieci publicznej. Domyślnie jest on włączony. Możesz dodatkowo ograniczyć do określonych adresów IP, konfigurując <polecenie seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.DomainProperties.InboundIpRules" />

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ResourceGroupName

Nazwa grupy zasobów w ramach subskrypcji użytkownika.

Typ:String
Aliasy:ResourceGroup
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SkuName

Nazwa jednostki SKU zasobu. Możliwe wartości to: Podstawowa lub Premium.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SubscriptionId

Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.

Typ:String
Position:Named
Domyślna wartość:(Get-AzContext).Subscription.Id
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Tag

Tagi zasobu.

Typ:Hashtable
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-UserAssignedIdentity

Tablica tożsamości przypisanych przez użytkownika skojarzona z zasobem. Elementy w tablicy będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

Typ:String[]
Aliasy:IdentityId
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

IEventGridIdentity

Dane wyjściowe

IDomain