Add-AzDnsRecordConfig

Ссылка

Модуль:: Az.Dns

Добавляет запись DNS в локальный объект набора записей.

Синтаксис

Add-AzDnsRecordConfig
   -RecordSet <DnsRecordSet>
   -Ipv4Address <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Add-AzDnsRecordConfig
   -RecordSet <DnsRecordSet>
   -Ipv6Address <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Add-AzDnsRecordConfig
   -RecordSet <DnsRecordSet>
   -Nsdname <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Add-AzDnsRecordConfig
   -RecordSet <DnsRecordSet>
   -Exchange <String>
   -Preference <UInt16>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Add-AzDnsRecordConfig
   -RecordSet <DnsRecordSet>
   -Ptrdname <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Add-AzDnsRecordConfig
   -RecordSet <DnsRecordSet>
   -Value <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Add-AzDnsRecordConfig
   -RecordSet <DnsRecordSet>
   -Priority <UInt16>
   -Target <String>
   -Port <UInt16>
   -Weight <UInt16>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Add-AzDnsRecordConfig
   -RecordSet <DnsRecordSet>
   -Cname <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Add-AzDnsRecordConfig
   -RecordSet <DnsRecordSet>
   -CaaFlags <Byte>
   -CaaTag <String>
   -CaaValue <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Add-AzDnsRecordConfig
   -RecordSet <DnsRecordSet>
   -KeyTag <Int32>
   -Algorithm <Int32>
   -DigestType <Int32>
   -Digest <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Add-AzDnsRecordConfig
   -RecordSet <DnsRecordSet>
   -Usage <Int32>
   -Selector <Int32>
   -MatchingType <Int32>
   -CertificateAssociationData <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Описание

Командлет Add-AzDnsRecordConfig добавляет запись системы доменных имен (DNS) в объект RecordSet. Объект RecordSet является автономным объектом, и изменения в нем не изменяют ответы DNS до тех пор, пока не выполните командлет Set-AzDnsRecordSet, чтобы сохранить изменение в службе DNS Microsoft Azure. Записи SOA создаются при создании зоны DNS и удаляются при удалении зоны DNS. Вы не можете добавлять или удалять записи SOA, но их можно изменить. Объект RecordSet можно передать этому командлету в качестве параметра или с помощью оператора конвейера.

Примеры

Пример 1. Добавление записи A в набор записей

$RecordSet = Get-AzDnsRecordSet -Name www -RecordType A -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 1.2.3.4
Set-AzDnsRecordSet -RecordSet $RecordSet

# You can also pipe the above sequence:

Get-AzDnsRecordSet -Name www -RecordType A -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzDnsRecordConfig -Ipv4Address 1.2.3.4 | Set-AzDnsRecordSet

В этом примере запись A добавляется в существующий набор записей.

Пример 2. Добавление записи AAAA в набор записей

$RecordSet = Get-AzDnsRecordSet -Name www -RecordType AAAA -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzDnsRecordConfig -RecordSet $RecordSet -Ipv6Address 2001:DB80:4009:1803::1005
Set-AzDnsRecordSet -RecordSet $RecordSet

# You can also pipe the above sequence:

Get-AzDnsRecordSet -Name www -RecordType AAAA -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzDnsRecordConfig -Ipv6Address 2001:DB80:4009:1803::1005 | Set-AzDnsRecordSet

В этом примере в существующий набор записей добавляется запись AAAA.

Пример 3. Добавление записи CNAME в набор записей

$RecordSet = Get-AzDnsRecordSet -Name www -RecordType CNAME -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzDnsRecordConfig -RecordSet $RecordSet -Cname contoso.com
Set-AzDnsRecordSet -RecordSet $RecordSet

# You can also pipe the above sequence:

Get-AzDnsRecordSet -Name www -RecordType CNAME -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzDnsRecordConfig -Cname contoso.com | Set-AzDnsRecordSet

В этом примере запись CNAME добавляется в существующий набор записей. Так как набор записей CNAME может содержать не более одной записи, изначально он должен быть пустым набором записей, или существующие записи должны быть удалены с помощью Remove-AzDnsRecordConfig.

Пример 4. Добавление записи MX в набор записей

$RecordSet = Get-AzDnsRecordSet -Name "@" -RecordType MX -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzDnsRecordConfig -Exchange mail.microsoft.com -Preference 5 -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# You can also pipe the above sequence:

Get-AzDnsRecordSet -Name "@" -RecordType MX -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzDnsRecordConfig -Exchange mail.microsoft.com -Preference 5 | Set-AzDnsRecordSet

В этом примере запись MX добавляется в существующий набор записей. Имя записи "@" указывает набор записей в вершине зоны.

Пример 5. Добавление записи NS в набор записей

$RecordSet = Get-AzDnsRecordSet -Name abc -RecordType NS -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzDnsRecordConfig -Nsdname ns1.myzone.com -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# You can also pipe the above sequence:

Get-AzDnsRecordSet -Name abc -RecordType NS -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzDnsRecordConfig -Nsdname ns1.myzone.com | Set-AzDnsRecordSet

В этом примере запись NS добавляется в существующий набор записей.

Пример 6. Добавление записи PTR в набор записей

$RecordSet = Get-AzDnsRecordSet -Name 4 -RecordType PTR -ResourceGroupName MyResourceGroup -ZoneName 3.2.1.in-addr.arpa
Add-AzDnsRecordConfig -Ptrdname www.contoso.com -RecordSet $RecordSet
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name 4 -RecordType PTR -ResourceGroupName MyResourceGroup -ZoneName 3.2.1.in-addr.arpa | Add-AzDnsRecordConfig -Ptrdname www.contoso.com | Set-AzDnsRecordSet

В этом примере запись PTR добавляется в существующий набор записей.

Пример 7. Добавление записи SRV в набор записей

$RecordSet = Get-AzDnsRecordSet -Name _sip._tcp -RecordType SRV -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzDnsRecordConfig -RecordSet $RecordSet -Priority 0 -Weight 5 -Port 8080 -Target target.example.com
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name _sip._tcp -RecordType SRV -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target target.example.com  | Set-AzDnsRecordSet

В этом примере запись SRV добавляется в существующий набор записей.

Пример 8. Добавление записи TXT в набор записей

$RecordSet = Get-AzDnsRecordSet -Name text -RecordType TXT -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzDnsRecordConfig -RecordSet $RecordSet -Value "This is a TXT Record"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name text -RecordType TXT -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzDnsRecordConfig -Value "This is a TXT Record" | Set-AzDnsRecordSet

В этом примере запись TXT добавляется в существующий набор записей.

Пример 9. Добавление записи DS в набор записей

$RecordSet = Get-AzDnsRecordSet -Name www -RecordType DS -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzDnsRecordConfig -RecordSet $RecordSet -KeyTag 12345 -Algorithm 3 -DigestType 1 -Digest "49FD46E6C4B45C55D4AC"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name www -RecordType DS -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzDnsRecordConfig -KeyTag 12345 -Algorithm 3 -DigestType 1 -Digest "49FD46E6C4B45C55D4AC" | Set-AzDnsRecordSet

Пример 10. Добавление записи TLSA в набор записей

$RecordSet = Get-AzDnsRecordSet -Name _443._tcp.www -RecordType TLSA -ResourceGroupName MyResourceGroup -ZoneName myzone.com
Add-AzDnsRecordConfig -RecordSet $RecordSet -Usage 3 -Selector 1 -MatchingType 1 -CertificateAssociationData "49FD46E6C4B45C55D4AC"
Set-AzDnsRecordSet -RecordSet $RecordSet

# The above sequence can also be piped:

Get-AzDnsRecordSet -Name _443._tcp.www -RecordType TLSA -ResourceGroupName MyResourceGroup -ZoneName myzone.com | Add-AzDnsRecordConfig -Usage 3 -Selector 1 -MatchingType 1 -CertificateAssociationData "49FD46E6C4B45C55D4AC" | Set-AzDnsRecordSet

Параметры

-Algorithm

Поле алгоритма добавляемой записи DS.

Тип:	Int32
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-CaaFlags

Флаги для добавляемой записи CAA. Должно быть число от 0 до 255.

Тип:	Byte
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-CaaTag

Поле тега записи CAA, добавляемой.

Тип:	String
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-CaaValue

Поле значения для добавляемой записи CAA.

Тип:	String
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-CertificateAssociationData

Поле данных сопоставления сертификатов для добавляемой записи TLSA.

Тип:	String
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Cname

Указывает доменное имя для записи канонического имени (CNAME).

Тип:	String
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure

Тип:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
значение по умолчанию:	None
Обязательно:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Digest

Поле дайджеста записи DS, добавляемой.

Тип:	String
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DigestType

Поле типа дайджеста для добавляемой записи DS.

Тип:	Int32
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Exchange

Указывает имя сервера обмена почтой для записи обмена почтой (MX).

Тип:	String
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Ipv4Address

Указывает IPv4-адрес для записи A.

Тип:	String
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Ipv6Address

Задает IPv6-адрес для записи AAAA.

Тип:	String
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-KeyTag

Поле тега ключа для добавляемой записи DS.

Тип:	Int32
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-MatchingType

Поле типа сопоставления для добавляемой записи TLSA.

Тип:	Int32
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Nsdname

Указывает имя сервера имен для записи сервера имен (NS).

Тип:	String
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Port

Указывает порт для записи службы (SRV).

Тип:	UInt16
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Preference

Задает предпочтение записи MX.

Тип:	UInt16
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Priority

Указывает приоритет записи SRV.

Тип:	UInt16
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Ptrdname

Указывает целевое доменное имя записи ресурса указателя (PTR).

Тип:	String
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-RecordSet

Указывает объект RecordSet для редактирования.

Тип:	DnsRecordSet
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Selector

Поле селектора для добавляемой записи TLSA.

Тип:	Int32
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Target

Указывает целевой объект для записи SRV.

Тип:	String
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Usage

Поле использования добавляемой записи TLSA.

Тип:	Int32
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Value

Задает значение записи TXT.

Тип:	String
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Weight

Задает вес записи SRV.

Тип:	UInt16
Position:	Named
значение по умолчанию:	None
Обязательно:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Входные данные

DnsRecordSet

String

UInt16

Byte

Выходные данные