New-AzDnsRecordSet
Crea un conjunto de registros DNS.
Sintaxis
New-AzDnsRecordSet
-Name <String>
-ZoneName <String>
-ResourceGroupName <String>
-Ttl <UInt32>
-RecordType <RecordType>
[-Metadata <Hashtable>]
[-DnsRecords <DnsRecordBase[]>]
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzDnsRecordSet
-Name <String>
-ZoneName <String>
-ResourceGroupName <String>
[-Ttl <UInt32>]
-RecordType <RecordType>
-TargetResourceId <String>
[-Metadata <Hashtable>]
[-DnsRecords <DnsRecordBase[]>]
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzDnsRecordSet
-Name <String>
-Zone <DnsZone>
-Ttl <UInt32>
-RecordType <RecordType>
[-Metadata <Hashtable>]
[-DnsRecords <DnsRecordBase[]>]
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzDnsRecordSet
-Name <String>
-Zone <DnsZone>
[-Ttl <UInt32>]
-RecordType <RecordType>
-TargetResourceId <String>
[-Metadata <Hashtable>]
[-DnsRecords <DnsRecordBase[]>]
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
El cmdlet New-AzDnsRecordSet crea un nuevo conjunto de registros del sistema de nombres de dominio (DNS) con el nombre y el tipo especificados en la zona especificada. Un objeto RecordSet es un conjunto de registros DNS con el mismo nombre y tipo. Tenga en cuenta que el nombre es relativo a la zona y no al nombre completo. El parámetro DnsRecords especifica los registros del conjunto de registros. Este parámetro toma una matriz de registros DNS, construidos mediante New-AzDnsRecordConfig. Puede usar el operador de canalización para pasar un objeto DnsZone a este cmdlet, o bien puede pasar un objeto DnsZone como parámetro Zone , o bien puede especificar la zona por nombre. Puede usar el parámetro Confirm y $ConfirmPreference variable de Windows PowerShell para controlar si el cmdlet le pide confirmación. Si ya existe un objeto RecordSet coincidente (mismo nombre y tipo de registro), debe especificar el parámetro Overwrite; de lo contrario, el cmdlet no creará un nuevo objeto RecordSet .
Ejemplos
Ejemplo 1: Crear un objeto RecordSet de tipo A
$Records = @()
$Records += New-AzDnsRecordConfig -IPv4Address 1.2.3.4
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records
# When creating a RecordSet containing a single record, the above sequence can also be condensed into a single line:
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords (New-AzDnsRecordConfig -IPv4Address 1.2.3.4)
# To create a record set containing multiple records, use New-AzDnsRecordConfig to add each record to the $Records array,
# then call New-AzDnsRecordSet, as follows:
$Records = @()
$Records += New-AzDnsRecordConfig -IPv4Address 1.2.3.4
$Records += New-AzDnsRecordConfig -IPv4Address 5.6.7.8
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $RecordsEn este ejemplo se crea un objeto RecordSet denominado www en la zona myzone.com. El conjunto de registros es de tipo A y tiene un TTL de 1 hora (3600 segundos). Contiene un único registro DNS.
Ejemplo 2: Crear un objeto RecordSet de tipo AAAA
$Records = @()
$Records += New-AzDnsRecordConfig -Ipv6Address 2001:db8::1
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $RecordsEn este ejemplo se crea un objeto RecordSet denominado www en la zona myzone.com. El conjunto de registros es de tipo AAAA y tiene un TTL de 1 hora (3600 segundos). Contiene un único registro DNS. Para crear un objeto RecordSet con solo una línea de pn_PowerShell_short, o para crear un conjunto de registros con varios registros, vea ejemplo 1.
Ejemplo 3: Crear un objeto RecordSet de tipo CNAME
$Records = @()
$Records += New-AzDnsRecordConfig -Cname www.contoso.com
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $RecordsEn este ejemplo se crea un objeto RecordSet denominado www en la zona myzone.com. El conjunto de registros es de tipo CNAME y tiene un TTL de 1 hora (3600 segundos). Contiene un único registro DNS. Para crear un objeto RecordSet con solo una línea de pn_PowerShell_short, o para crear un conjunto de registros con varios registros, vea ejemplo 1.
Ejemplo 4: Crear un objeto RecordSet de tipo MX
$Records = @()
$Records += New-AzDnsRecordConfig -Exchange "mail.microsoft.com" -Preference 5
$RecordSet = New-AzDnsRecordSet -Name "mail" -RecordType MX -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $RecordsEste comando crea un objeto RecordSet denominado www en la zona myzone.com. El conjunto de registros es de tipo MX y tiene un TTL de 1 hora (3600 segundos). Contiene un único registro DNS. Para crear un objeto RecordSet con solo una línea de pn_PowerShell_short, o para crear un conjunto de registros con varios registros, vea ejemplo 1.
Ejemplo 5: Crear un objeto RecordSet de tipo NS
$Records = @()
$Records += New-AzDnsRecordConfig -Nsdname ns1-01.azure-dns.com
$RecordSet = New-AzDnsRecordSet -Name "ns1" -RecordType NS -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $RecordsEste comando crea un objeto RecordSet denominado ns1 en la zona myzone.com. El conjunto de registros es de tipo NS y tiene un TTL de 1 hora (3600 segundos). Contiene un único registro DNS. Para crear un objeto RecordSet con solo una línea de pn_PowerShell_short, o para crear un conjunto de registros con varios registros, vea ejemplo 1.
Ejemplo 6: Crear un objeto RecordSet de tipo PTR
$Records = @()
$Records += New-AzDnsRecordConfig -Ptrdname www.contoso.com
$RecordSet = New-AzDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "3.2.1.in-addr.arpa" -DnsRecords $RecordsEste comando crea un objeto RecordSet denominado 4 en la zona 3.2.1.in-addr.arpa. El conjunto de registros es de tipo PTR y tiene un TTL de 1 hora (3600 segundos). Contiene un único registro DNS. Para crear un objeto RecordSet con solo una línea de pn_PowerShell_short, o para crear un conjunto de registros con varios registros, vea ejemplo 1.
Ejemplo 7: Crear un objeto RecordSet de tipo SRV
$Records = @()
$Records += New-AzDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target sipservice.contoso.com
$RecordSet = New-AzDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $RecordsEste comando crea un objeto RecordSet denominado _sip._tcp en la zona myzone.com. El conjunto de registros es de tipo SRV y tiene un TTL de 1 hora (3600 segundos). Contiene un único registro DNS que apunta a la dirección IP 2001.2.3.4. El servicio (sip) y el protocolo (tcp) se especifican como parte del nombre del conjunto de registros, no como parte de los datos de registro. Para crear un objeto RecordSet con solo una línea de pn_PowerShell_short, o para crear un conjunto de registros con varios registros, vea ejemplo 1.
Ejemplo 8: Crear un objeto RecordSet de tipo TXT
$Records = @()
$Records += New-AzDnsRecordConfig -Value "This is a TXT Record"
$RecordSet = New-AzDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $RecordsEste comando crea un objeto RecordSet denominado text en la zona myzone.com. El conjunto de registros es de tipo TXT y tiene un TTL de 1 hora (3600 segundos). Contiene un único registro DNS. Para crear un objeto RecordSet con solo una línea de pn_PowerShell_short, o para crear un conjunto de registros con varios registros, vea ejemplo 1.
Ejemplo 9: Crear un objeto RecordSet en el vértice de la zona
$Records = @()
$Records += New-AzDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzDnsRecordSet -Name "@" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $RecordsEste comando crea un objeto RecordSet en el vértice (o raíz) de la myzone.com de zona. Para ello, el nombre del conjunto de registros se especifica como "@" (incluidas las comillas dobles). No se pueden crear registros CNAME en el vértice de una zona. Se trata de una restricción de los estándares DNS; no es una limitación de Azure DNS. Para crear un objeto RecordSet con solo una línea de pn_PowerShell_short, o para crear un conjunto de registros con varios registros, vea ejemplo 1.
Ejemplo 10: Crear un conjunto de registros comodín
$Records = @()
$Records += New-AzDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzDnsRecordSet -Name "*" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $RecordsEste comando crea un objeto RecordSet denominado * en la zona myzone.com. Se trata de un conjunto de registros comodín. Para crear un objeto RecordSet con solo una línea de pn_PowerShell_short, o para crear un conjunto de registros con varios registros, vea ejemplo 1.
Ejemplo 11: Crear un conjunto de registros vacío
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords @()Este comando crea un objeto RecordSet denominado www en la zona myzone.com. El conjunto de registros es de tipo A y tiene un TTL de 1 hora (3600 segundos). Se trata de un conjunto de registros vacío, que actúa como marcador de posición al que puede agregar más adelante registros.
Ejemplo 12: Crear un conjunto de registros y suprimir toda la confirmación
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords (New-AzDnsRecordConfig -Ipv4Address 1.2.3.4) -Confirm:$False -OverwriteEste comando crea un objeto RecordSet. El parámetro Overwrite garantiza que este conjunto de registros sobrescribe cualquier conjunto de registros preexistente con el mismo nombre y tipo (se pierden los registros existentes en ese conjunto de registros). El parámetro Confirm con un valor de $False suprime el mensaje de confirmación.
Parámetros
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posición: | Named |
| Valor predeterminado: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure
| Tipo: | IAzureContextContainer |
| Alias: | AzContext, AzureRmContext, AzureCredential |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DnsRecords
Especifica la matriz de registros DNS que se van a incluir en el conjunto de registros. Puede usar el cmdlet New-AzDnsRecordConfig para crear objetos de registro DNS. Para obtener más información, vea los ejemplos.
| Tipo: | DnsRecordBase[] |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Metadata
Especifica una matriz de metadatos que se van a asociar al objeto RecordSet. Los metadatos se especifican mediante pares nombre-valor que se representan como tablas hash, por ejemplo @{"dept"="shopping";" env"="production"}.
| Tipo: | Hashtable |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Name
Especifica el nombre del objeto RecordSet que se va a crear.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Overwrite
Indica que este cmdlet sobrescribe el objeto RecordSet especificado si ya existe.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-RecordType
Especifica el tipo de registro DNS que se va a crear. Los valores válidos son:
- A
- AAAA
- CNAME
- MX
- NS
- PTR
- SRV
- Los registros SOA TXT se crean automáticamente cuando se crea la zona y no se pueden crear manualmente.
| Tipo: | RecordType |
| Valores aceptados: | A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-ResourceGroupName
Especifica el grupo de recursos que contiene la zona DNS. También debe especificar el parámetro ZoneName para especificar el nombre de zona. Como alternativa, puede especificar la zona y el grupo de recursos pasando un objeto Zona DNS mediante el parámetro Zone .
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-TargetResourceId
Identificador de recurso de destino de alias.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Ttl
Especifica el período de vida (TTL) para el objeto RecordSet DNS.
| Tipo: | UInt32 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| 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: | False |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Zone
Especifica la zona dns en la que se va a crear el objeto RecordSet. Como alternativa, puede especificar la zona mediante los parámetros ZoneName y ResourceGroupName .
| Tipo: | DnsZone |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-ZoneName
Especifica el nombre de la zona en la que se va a crear el objeto RecordSet. También debe especificar el grupo de recursos que contiene la zona mediante el parámetro ResourceGroupName . Como alternativa, puede especificar la zona y el grupo de recursos pasando un objeto Zona DNS mediante el parámetro Zone .
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
Entradas
Salidas
Notas
Puede usar el parámetro Confirm para controlar si este cmdlet le pide confirmación. De forma predeterminada, el cmdlet le pide confirmación si la variable de Windows PowerShell $ConfirmPreference tiene un valor de Medium o lower. Si especifica Confirm o Confirm:$True, este cmdlet le pedirá confirmación antes de que se ejecute. Si especifica Confirm:$False, el cmdlet no le pide confirmación.
Vínculos relacionados
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