Compartir a través de


New-AzDnsRecordConfig

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>]

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 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 "www" -RecordType AAAA -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 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 objeto RecordSet denominado 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 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: 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 objeto 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 objeto RecordSet con 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

-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

-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.

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

-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

-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