New-AzDnsRecordSet

Referencia

Módulo:: Az.Dns

Crea un conjunto de registros DNS.

Syntax

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.

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

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	DnsRecordBase[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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"}.

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

-Name

Especifica el nombre del objeto RecordSet que se va a crear.

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

-Overwrite

Indica que este cmdlet sobrescribe el objeto RecordSet especificado si ya existe.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	RecordType
Accepted values:	A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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 .

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

-TargetResourceId

Identificador de recurso de destino de alias.

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

-Ttl

Especifica el período de vida (TTL) para el objeto RecordSet DNS.

Type:	UInt32
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
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:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 .

Type:	DnsZone
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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 .

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	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.