New-AzEventGridDomain
Crea o actualiza de forma asincrónica un nuevo dominio con los parámetros especificados.
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
Crea o actualiza de forma asincrónica un nuevo dominio con los parámetros especificados.
Ejemplos
Ejemplo 1: Crear asincrónicamente un nuevo dominio con los parámetros especificados.
$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_eventgridCree de forma asincrónica un nuevo dominio con los parámetros especificados.
Parámetros
-AsJob
Ejecución del comando como trabajo
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AutoCreateTopicWithFirstSubscription
Este valor booleano se usa para especificar el mecanismo de creación para "todos" los temas de dominio de Event Grid asociados a este recurso de dominio de Event Grid. En este contexto, la creación de un tema de dominio se puede administrar automáticamente (cuando es true) o administrarse automáticamente (cuando es false). El valor predeterminado de esta propiedad es true. Cuando esta propiedad es null o se establece en true, Event Grid es responsable de crear automáticamente el tema de dominio cuando se crea la primera suscripción de eventos en el ámbito del tema de dominio. Si esta propiedad se establece en false, la creación de la primera suscripción de eventos requerirá la creación de un tema de dominio por parte del usuario. El modo de autoadministración se puede usar si el usuario quiere tener control total de cuándo se crea el tema de dominio, mientras que el modo administrado automáticamente proporciona la flexibilidad para realizar menos operaciones y administrar menos recursos por el usuario. Además, tenga en cuenta que, en modo de creación administrada automáticamente, el usuario puede crear el tema de dominio a petición si es necesario.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AutoDeleteTopicWithLastSubscription
Este valor booleano se usa para especificar el mecanismo de eliminación para "todos" los temas de dominio de Event Grid asociados a este recurso de dominio de Event Grid. En este contexto, la eliminación del tema de dominio se puede administrar automáticamente (cuando es true) o administrarse automáticamente (cuando es false). El valor predeterminado de esta propiedad es true. Cuando esta propiedad se establece en true, Event Grid es responsable de eliminar automáticamente el tema de dominio cuando se elimina la última suscripción de eventos en el ámbito del tema de dominio. Si esta propiedad se establece en false, el usuario debe eliminar manualmente el tema de dominio cuando ya no sea necesario (por ejemplo, cuando se elimine la última suscripción de eventos y el recurso deba limpiarse). El modo de autoadministración se puede usar si el usuario quiere controlar completamente cuándo se debe eliminar el tema del dominio, mientras que el modo administrado automático proporciona la flexibilidad para realizar menos operaciones y administrar menos recursos por parte del usuario.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DataResidencyBoundary
Límite de residencia de datos del recurso.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
El parámetro DefaultProfile no es funcional. Use el parámetro SubscriptionId cuando esté disponible si ejecuta el cmdlet en otra suscripción.
| Type: | PSObject |
| Aliases: | AzureRMContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableLocalAuth
Este valor booleano se usa para habilitar o deshabilitar la autenticación local. El valor predeterminado es false. Cuando la propiedad se establece en true, solo se usará el token de AAD para autenticarse si el usuario puede publicar en el dominio.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableSystemAssignedIdentity
Decide si habilita una identidad asignada por el sistema para el recurso.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EventTypeInfoInlineEventType
Colección de tipos de eventos insertados para el recurso. Las claves de tipo de evento insertadas son de tipo cadena que representa el nombre del evento. Un ejemplo de un nombre de evento insertado válido es "Contoso.OrderCreated". Los valores de tipo de evento insertado son de tipo InlineEventProperties y contendrán información adicional para cada tipo de evento insertado.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EventTypeInfoKind
Tipo de evento usado.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IdentityPrincipalId
Identificador de entidad de seguridad de la identidad del recurso.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IdentityTenantId
Identificador de inquilino del recurso.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InboundIPRule
Esto se puede usar para restringir el tráfico de direcciones IP específicas en lugar de todas las direcciones IP. Nota: Estos se consideran solo si PublicNetworkAccess está habilitado.
| Type: | IInboundIPRule[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Parámetro de identidad
| Type: | IEventGridIdentity |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-InputSchema
Esto determina el formato que Event Grid debe esperar para los eventos entrantes publicados en el recurso de dominio de Event Grid.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JsonFilePath
Ruta de acceso del archivo Json proporcionado a la operación Create
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JsonString
Cadena JSON proporcionada a la operación Create
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Location
Ubicación del recurso.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinimumTlsVersionAllowed
Versión mínima de TLS del publicador que permite publicar en este dominio
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Nombre del dominio.
| Type: | String |
| Aliases: | DomainName |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoWait
Ejecutar el comando de forma asincrónica
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
Devuelve true cuando el comando se ejecuta correctamente.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PublicNetworkAccess
Esto determina si se permite el tráfico a través de la red pública. De forma predeterminada, está habilitado. Puede restringir aún más a direcciones IP específicas configurando <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.DomainProperties.InboundIpRules" />
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ResourceGroupName
Nombre del grupo de recursos dentro de la suscripción del usuario.
| Type: | String |
| Aliases: | ResourceGroup |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SkuName
Nombre de Sku del recurso. Los valores posibles son: Básico o Premium.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SubscriptionId
Credenciales de suscripción que identifican de forma única una suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI para cada llamada al servicio.
| Type: | String |
| Position: | Named |
| Default value: | (Get-AzContext).Subscription.Id |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tag
Etiquetas del recurso.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserAssignedIdentity
Matriz de identidades asignadas por el usuario asociadas al recurso. Los elementos de la matriz serán identificadores de recursos de ARM con el 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
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Entradas
Salidas
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de