New-AzDnsRecordConfig

Módulo:

Az.Dns

Crea un nuevo objeto local de registro DNS.

Sintaxis

New-AzDnsRecordConfig
   -Ipv4Address <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzDnsRecordConfig
   -Ipv6Address <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzDnsRecordConfig
   -Nsdname <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzDnsRecordConfig
   -Exchange <String>
   -Preference <UInt16>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzDnsRecordConfig
   -Ptrdname <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzDnsRecordConfig
   -Value <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzDnsRecordConfig
   -Priority <UInt16>
   -Target <String>
   -Port <UInt16>
   -Weight <UInt16>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzDnsRecordConfig
   -Cname <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzDnsRecordConfig
   -CaaFlags <Byte>
   -CaaTag <String>
   -CaaValue <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzDnsRecordConfig
   -KeyTag <Int32>
   -Algorithm <Int32>
   -DigestType <Int32>
   -Digest <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzDnsRecordConfig
   -Usage <Int32>
   -Selector <Int32>
   -MatchingType <Int32>
   -CertificateAssociationData <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

New-AzDnsRecordConfig
   -Flags <UInt16>
   -Order <UInt16>
   -Preference <UInt16>
   -Services <String>
   -Regexp <String>
   -Replacement <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

El cmdlet New-AzDnsRecordConfig crea un objeto dnsRecord local. Una matriz de estos objetos se pasa al cmdlet New-AzDnsRecordSet mediante el parámetro DnsRecords para especificar los registros que se van a crear en el conjunto de registros.

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 recordSet de 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 recordSet de 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 RecordSet usando 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 recordSet de 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 RecordSet usando 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 "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Este comando crea un recordSet de 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 RecordSet usando 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 RecordSet denominado ns1 en el myzone.com de zona. 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 RecordSet usando 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 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 RecordSet usando 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 recordSet de denominado _sip._tcp en el myzone.com de zona. 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 RecordSet usando 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 RecordSet texto con nombre en el myzone.com de zona. 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 RecordSet usando 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 de tipo DS

$Records = @()
$Records += New-AzDnsRecordConfig -KeyTag 12345 -Algorithm 3 -DigestType 1 -Digest "49FD46E6C4B45C55D4AC"
$RecordSet = New-AzDnsRecordSet -Name "childds" -RecordType DS -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Este comando crea un RecordSet denominados childds en la zona myzone.com. El conjunto de registros es de tipo DS y tiene un TTL de 1 hora (3600 segundos). Contiene un único registro DNS. Los datos de registro contienen la etiqueta de clave, el algoritmo, el tipo de resumen y la síntesis del registro DNSKEY de la zona secundaria. Para crear un RecordSet usando solo una línea de pn_PowerShell_short, o para crear un conjunto de registros con varios registros, vea ejemplo 1.

Ejemplo 10: Creación de un objeto RecordSet de tipo TLSA

$Records = @()
$Records += New-AzDnsRecordConfig -Usage 3 -Selector 1 -MatchingType 1 -CertificateAssociationData "49FD46E6C4B45C55D4AC"
$RecordSet = New-AzDnsRecordSet -Name "_443._tcp.www" -RecordType TLSA -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Este comando crea un RecordSet denominado _443._tcp.www en la zona myzone.com. El conjunto de registros es de tipo TLSA y tiene un TTL de 1 hora (3600 segundos). Contiene un único registro DNS. Los datos de registro contienen el uso, el selector y el tipo coincidente de los datos de asociación de certificados. Para crear un RecordSet usando 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 objeto RecordSet de tipo NAPTR

$Records = @()
$Records += New-AzDnsRecordConfig -Flags 0 -Order 100 -Preference 100 -Services "SIP+D2U" -Regexp "" -Replacement "example.com"
$RecordSet = New-AzDnsRecordSet -Name "naptr123" -RecordType NAPTR -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Este comando crea un RecordSet denominado naptr123 en la myzone.com de zona. El conjunto de registros es de tipo NAPTR y tiene un TTL de 1 hora (3600 segundos). Contiene un único registro DNS. Los datos de registro contienen los campos order, preference, flags, services, regexp y replacement. Para crear un RecordSet usando solo una línea de pn_PowerShell_short, o para crear un conjunto de registros con varios registros, vea ejemplo 1.

Parámetros

-Algorithm

Campo de algoritmo del registro DS que se va a agregar.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-CaaFlags

Marcas del registro CAA que se va a agregar. Debe ser un número comprendido entre 0 y 255.

Tipo:	Byte
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-CaaTag

Campo de etiqueta del registro CAA que se va a agregar.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-CaaValue

Campo de valor del registro CAA que se va a agregar.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-CertificateAssociationData

Campo de datos de asociación de certificado del registro TLSA que se va a agregar.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Cname

Especifica el nombre de dominio de un registro de nombre canónico (CNAME).

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
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

-Digest

Campo de resumen del registro DS que se va a agregar.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-DigestType

Campo de tipo de resumen del registro DS que se va a agregar.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Exchange

Especifica el nombre del servidor de intercambio de correo para un registro de intercambio de correo (MX).

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Flags

Especifica las marcas de un registro NAPTR.

Tipo:	UInt16
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Ipv4Address

Especifica una dirección IPv4 para un registro A.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Ipv6Address

Especifica una dirección IPv6 para un registro AAAA.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-KeyTag

Campo de etiqueta de clave del registro DS que se va a agregar.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-MatchingType

Campo de tipo coincidente del registro TLSA que se va a agregar.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Nsdname

Especifica el nombre del servidor de nombres para un registro de servidor de nombres (NS).

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Order

Especifica el orden de un registro NAPTR.

Tipo:	UInt16
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Port

Especifica el puerto de un registro de servicio (SRV).

Tipo:	UInt16
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Preference

Especifica la preferencia de un registro MX/NAPTR.

Tipo:	UInt16
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Priority

Especifica la prioridad de un registro SRV.

Tipo:	UInt16
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Ptrdname

Especifica el nombre de dominio de destino de un registro de recursos de puntero (PTR).

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Regexp

Especifica el regexp de un registro NAPTR.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Replacement

Especifica el reemplazo de un registro NAPTR.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Selector

Campo selector del registro TLSA que se va a agregar.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Services

Especifica los servicios de un registro NAPTR.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Target

Especifica el destino de un registro SRV.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Usage

Campo de uso del registro TLSA que se va a agregar.

Tipo:	Int32
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Value

Especifica el valor de un registro TXT.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Weight

Especifica el peso de un registro SRV.

Tipo:	UInt16
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

Entradas

String

UInt16

Byte

Salidas

DnsRecordBase

Vínculos relacionados

• Add-AzDnsRecordConfig
• New-AzDnsRecordSet
• Remove-AzDnsRecordConfig