Compartilhar via


New-AzEventGridTopic

Cria de forma assíncrona um novo tópico com os parâmetros especificados.

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

Description

Cria de forma assíncrona um novo tópico com os parâmetros especificados.

Exemplos

Exemplo 1: Cria de forma assíncrona um novo tópico com os parâmetros especificados.

$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

Cria de forma assíncrona um novo tópico com os parâmetros especificados.

Parâmetros

-AsJob

Executar o comando como um trabalho

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DataResidencyBoundary

Limite de residência de dados do recurso.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

O parâmetro DefaultProfile não está funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableLocalAuth

Esse booleano é usado para habilitar ou desabilitar a autenticação local. O valor padrão é false. Quando a propriedade é definida como true, somente o token AAD será usado para autenticar se o usuário tiver permissão para publicar no tópico.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableSystemAssignedIdentity

Decide se habilita uma identidade atribuída ao sistema para o recurso.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EventTypeInfoInlineEventType

Uma coleção de tipos de eventos embutidos para o recurso. As chaves de tipo de evento embutidas são do tipo string que representa o nome do evento. Um exemplo de um nome de evento embutido válido é "Contoso.OrderCreated". Os valores de tipo de evento embutido são do tipo InlineEventProperties e conterão informações adicionais para cada tipo de evento embutido.

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EventTypeInfoKind

O tipo de evento usado.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExtendedLocationName

Nome totalmente qualificado do local estendido.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExtendedLocationType

Tipo do local estendido.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IdentityPrincipalId

A ID principal da identidade do recurso.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IdentityTenantId

A ID do locatário do recurso.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InboundIPRule

Isso pode ser usado para restringir o tráfego de IPs específicos em vez de todos os IPs. Nota: Eles são considerados somente se PublicNetworkAccess estiver habilitado.

Type:IInboundIPRule[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Parâmetro de identidade

Type:IEventGridIdentity
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InputSchema

Isso determina o formato que a Grade de Eventos deve esperar para eventos de entrada publicados no tópico.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JsonFilePath

Caminho do arquivo Json fornecido para a operação Create

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-JsonString

Cadeia de caracteres Json fornecida à operação Create

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Kind

Tipo do recurso.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Location

Localização do recurso.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-MinimumTlsVersionAllowed

Versão TLS mínima do editor permitida para publicar neste tópico

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Nome do tópico.

Type:String
Aliases:TopicName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-NoWait

Execute o comando de forma assíncrona

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Retorna true quando o comando é bem-sucedido

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicNetworkAccess

Isso determina se o tráfego é permitido na rede pública. Por padrão, ele está habilitado. Você pode restringir ainda mais IPs específicos configurando <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.TopicProperties.InboundIpRules" />

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

O nome do grupo de recursos dentro da assinatura do usuário.

Type:String
Aliases:ResourceGroup
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SkuName

O nome da Sku do recurso. Os valores possíveis são: Básico ou Premium.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

Credenciais de assinatura que identificam exclusivamente uma assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.

Type:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

Tags do recurso.

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserAssignedIdentity

A matriz de identidades atribuídas pelo usuário associadas ao recurso. Os elementos na matriz serão ids de recursos ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.'

Type:String[]
Aliases:IdentityId
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

IEventGridIdentity

Saídas

ITopic