New-AzEventGridDomain
Crea o actualiza de forma asincrónica un nuevo dominio con los parámetros especificados.
Sintaxis
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
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DataResidencyBoundary
Límite de residencia de datos del recurso.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | PSObject |
| Alias: | AzureRMContext, AzureCredential |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-EnableSystemAssignedIdentity
Decide si habilita una identidad asignada por el sistema para el recurso.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | Hashtable |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-EventTypeInfoKind
Tipo de evento usado.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-IdentityPrincipalId
Identificador de entidad de seguridad de la identidad del recurso.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-IdentityTenantId
Identificador de inquilino del recurso.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | IInboundIPRule[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-InputObject
Parámetro de identidad
| Tipo: | IEventGridIdentity |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-InputSchema
Esto determina el formato que Event Grid debe esperar para los eventos entrantes publicados en el recurso de dominio de Event Grid.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-JsonFilePath
Ruta de acceso del archivo Json proporcionado a la operación Create
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-JsonString
Cadena JSON proporcionada a la operación Create
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Location
Ubicación del recurso.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-MinimumTlsVersionAllowed
Versión mínima de TLS del publicador que permite publicar en este dominio
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Name
Nombre del dominio.
| Tipo: | String |
| Alias: | DomainName |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-NoWait
Ejecutar el comando de forma asincrónica
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-PassThru
Devuelve true cuando el comando se ejecuta correctamente.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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" />
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ResourceGroupName
Nombre del grupo de recursos dentro de la suscripción del usuario.
| Tipo: | String |
| Alias: | ResourceGroup |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-SkuName
Nombre de Sku del recurso. Los valores posibles son: Básico o Premium.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | (Get-AzContext).Subscription.Id |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Tag
Etiquetas del recurso.
| Tipo: | Hashtable |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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}.'
| Tipo: | String[] |
| Alias: | IdentityId |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | 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