Compartir a través de

New-AzDnsRecordSet

  • Referencia
Módulo:
Az.Dns

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 $Records

En 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 $Records

En 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 $Records

En 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 $Records

Este 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 $Records

Este 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 $Records

Este 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 $Records

Este 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 $Records

Este 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 $Records

Este 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 $Records

Este 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 -Overwrite

Este 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

String

DnsZone

UInt32

RecordType

Hashtable

DnsRecordBase[]

Salidas

DnsRecordSet

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.