New-AzPrivateDnsRecordSet
Crea un conjunto de registros en una zona DNS privada.
Sintaxis
New-AzPrivateDnsRecordSet
-ResourceGroupName <String>
-ZoneName <String>
-Name <String>
-RecordType <RecordType>
-Ttl <UInt32>
[-Metadata <Hashtable>]
[-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzPrivateDnsRecordSet
-Zone <PSPrivateDnsZone>
-Name <String>
-RecordType <RecordType>
-Ttl <UInt32>
[-Metadata <Hashtable>]
[-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzPrivateDnsRecordSet
-ParentResourceId <String>
-Name <String>
-RecordType <RecordType>
-Ttl <UInt32>
[-Metadata <Hashtable>]
[-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
El cmdlet New-AzPrivateDnsRecordSet crea un nuevo conjunto de registros del Sistema de nombres de dominio privado (DNS) con el nombre y el tipo especificados en la zona privada especificada. Un objeto RecordSet es un conjunto de registros DNS privados con el mismo nombre y tipo. Tenga en cuenta que el nombre es relativo a la zona privada y no al nombre completo. El parámetro PrivateDnsRecord especifica los registros del conjunto de registros. Este parámetro toma una matriz de registros DNS privados, construidos mediante New-AzPrivateDnsRecordConfig. Puede usar el operador de canalización para pasar un objeto PSPrivateDnsZone a este cmdlet, o bien puede pasar un objeto PSPrivateDnsZone como parámetro Zone, o bien puede especificar la zona por su ResourceId, 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-AzPrivateDnsRecordConfig -IPv4Address 1.2.3.4
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
# When creating a RecordSet containing a single record, the above sequence can also be condensed into a single line:
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords (New-AzPrivateDnsRecordConfig -IPv4Address 1.2.3.4)
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.Netwo
rk/privateDnsZones/myzone.com/A/www
Name : www
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : A
Records : {1.2.3.4}
Metadata :
IsAutoRegistered :
# To create a record set containing multiple records, use New-AzPrivateDnsRecordConfig to add each record to the $Records array,
# then call New-AzPrivateDnsRecordSet, as follows:
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -IPv4Address 1.2.3.4
$Records += New-AzPrivateDnsRecordConfig -IPv4Address 5.6.7.8
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.Netwo
rk/privateDnsZones/myzone.com/A/www
Name : www
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : A
Records : {1.2.3.4, 5.6.7.8}
Metadata :
IsAutoRegistered :En este ejemplo se crea un objeto RecordSet denominado www en la zona privada myzone.com. El conjunto de registros es de tipo A y tiene un TTL de 1 hora (3600 segundos). Contiene un único registro DNS privado.
Ejemplo 2: Crear un objeto RecordSet de tipo AAAA
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ipv6Address 2001:db8::1
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/AAAA/www
Name : www
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : AAAA
Records : {2001:db8::1}
Metadata :
IsAutoRegistered :En este ejemplo se crea un objeto RecordSet denominado www en la zona privada myzone.com. El conjunto de registros es de tipo AAAA y tiene un TTL de 1 hora (3600 segundos). Contiene un único registro DNS privado. Para crear un objeto RecordSet con una sola 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-AzPrivateDnsRecordConfig -Cname www.contoso.com
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/CNAME/www
Name : www
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : CNAME
Records : {www.contoso.com}
Metadata :
IsAutoRegistered :En este ejemplo se crea un objeto RecordSet denominado www en la zona privada myzone.com. El conjunto de registros es de tipo CNAME y tiene un TTL de 1 hora (3600 segundos). Contiene un único registro DNS privado. Para crear un objeto RecordSet con una sola 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-AzPrivateDnsRecordConfig -Exchange "mail.microsoft.com" -Preference 5
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType MX -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/MX/www
Name : www
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : MX
Records : {[5,mail.microsoft.com]}
Metadata :
IsAutoRegistered :Este comando crea un objeto RecordSet denominado www en la zona privada myzone.com. El conjunto de registros es de tipo MX y tiene un TTL de 1 hora (3600 segundos). Contiene un único registro DNS privado. Para crear un objeto RecordSet con una sola 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 PTR
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ptrdname www.contoso.com
$RecordSet = New-AzPrivateDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "3.2.1.in-addr.arpa" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/3.2.1.in-addr.arpa/PTR/4
Name : 4
ZoneName : 3.2.1.in-addr.arpa
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : PTR
Records : {www.contoso.com}
Metadata :
IsAutoRegistered :Este comando crea un objeto RecordSet denominado 4 en la zona privada 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 privado. Para crear un objeto RecordSet con una sola 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 SRV
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target sipservice.contoso.com
$RecordSet = New-AzPrivateDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/SRV/_sip._tcp
Name : _sip._tcp
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : SRV
Records : {[0,5,8080,sipservice.contoso.com]}
Metadata :
IsAutoRegistered :Este comando crea un objeto RecordSet denominado _sip._tcp en la zona privada myzone.com. El conjunto de registros es de tipo SRV y tiene un TTL de 1 hora (3600 segundos). Contiene un único registro DNS privado 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 una sola 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 TXT
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Value "This is a TXT Record"
$RecordSet = New-AzPrivateDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/TXT/text
Name : text
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : TXT
Records : {This is a TXT Record}
Metadata :
IsAutoRegistered :Este comando crea un objeto RecordSet denominado text en la zona privada myzone.com. El conjunto de registros es de tipo TXT y tiene un TTL de 1 hora (3600 segundos). Contiene un único registro DNS privado. Para crear un objeto RecordSet con una sola 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 en el vértice de zona
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzPrivateDnsRecordSet -Name "@" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/A/@
Name : @
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : A
Records : {1.2.3.4}
Metadata :
IsAutoRegistered :Este comando crea un objeto RecordSet en el vértice (o raíz) de la zona privada myzone.com. 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 del DNS privado de Azure. Para crear un objeto RecordSet con una sola línea de pn_PowerShell_short, o para crear un conjunto de registros con varios registros, vea ejemplo 1.
Ejemplo 9: Crear un conjunto de registros comodín
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzPrivateDnsRecordSet -Name "*" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/A/@
Name : *
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : A
Records : {1.2.3.4}
Metadata :
IsAutoRegistered :Este comando crea un objeto RecordSet denominado * en la zona privada myzone.com. Se trata de un conjunto de registros comodín. Para crear un objeto RecordSet con una sola 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 vacío
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords @()
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/A/@
Name : *
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : A
Records : {}
Metadata :
IsAutoRegistered :Este comando crea un objeto RecordSet denominado * en la zona privada 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 11: Crear un conjunto de registros y suprimir toda la confirmación
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords (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 pide confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posición: | Named |
| Valor predeterminado: | None |
| 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 |
-Metadata
Tabla hash que representa etiquetas de recursos.
| Tipo: | Hashtable |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Name
Nombre de los registros de este conjunto de registros (relativo al nombre de la zona y sin un punto de terminación).
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Overwrite
No se produce un error si el conjunto de registros ya existe.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ParentResourceId
ResourceID de zona DNS privada.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-PrivateDnsRecord
Registros dns privados que forman parte de este conjunto de registros.
| Tipo: | PSPrivateDnsRecordBase[] |
| Alias: | PrivateDnsRecords |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-RecordType
Tipo de registros DNS privados en este conjunto de registros.
| Tipo: | RecordType |
| Valores aceptados: | A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ResourceGroupName
Grupo de recursos al que pertenece la zona.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Ttl
Valor TTL de todos los registros de este conjunto de registros.
| Tipo: | UInt32 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Zone
Objeto PrivateDnsZone que representa la zona en la que se va a crear el conjunto de registros.
| Tipo: | PSPrivateDnsZone |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-ZoneName
Zona en la que se va a crear el conjunto de registros (sin un punto de terminación).
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
