Поделиться через

New-AzDnsRecordSet

  • Ссылка
Модуль:
Az.Dns

Создает набор записей DNS.

Синтаксис

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

Описание

Командлет New-AzDnsRecordSet создает набор записей системы доменных имен (DNS) с указанным именем и типом в указанной зоне. Объект RecordSet — это набор записей DNS с тем же именем и типом. Обратите внимание, что имя относительно зоны и не полное имя. Параметр DnsRecords указывает записи в наборе записей. Этот параметр принимает массив записей DNS, созданных с помощью New-AzDnsRecordConfig. Оператор конвейера можно использовать для передачи объекта DnsZone в этот командлет или передать объект DnsZone в качестве параметра зоны или указать зону по имени. Вы можете использовать параметр и $ConfirmPreference переменную Windows PowerShell, чтобы контролировать, запрашивает ли командлет подтверждение. Если соответствующий RecordSet уже существует (то же имя и тип записи), необходимо указать параметр Overwrite, в противном случае командлет не создаст новый RecordSet.

Примеры

Пример 1. Создание набора записей типа 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

В этом примере создается RecordSet с именем www в зоне myzone.com. Набор записей имеет тип A и имеет TTL 1 час (3600 секунд). Он содержит одну запись DNS.

Пример 2. Создание набора записей типа 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

В этом примере создается RecordSet с именем www в зоне myzone.com. Набор записей имеет тип AAAA и имеет TTL 1 час (3600 секунд). Он содержит одну запись DNS. Чтобы создать RecordSet с помощью только одной строки pn_PowerShell_short, или создать набор записей с несколькими записями, см. пример 1.

Пример 3. Создание набора записей типа 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

В этом примере создается RecordSet с именем www в зоне myzone.com. Набор записей имеет тип CNAME и имеет TTL 1 час (3600 секунд). Он содержит одну запись DNS. Чтобы создать RecordSet с помощью только одной строки pn_PowerShell_short, или создать набор записей с несколькими записями, см. пример 1.

Пример 4. Создание набора записей типа 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

Эта команда создает RecordSet www в зоне myzone.com. Набор записей имеет тип MX и имеет TTL 1 час (3600 секунд). Он содержит одну запись DNS. Чтобы создать RecordSet с помощью только одной строки pn_PowerShell_short, или создать набор записей с несколькими записями, см. пример 1.

Пример 5. Создание набора записей типа 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

Эта команда создает RecordSet с именем ns1 в myzone.com зоны. Набор записей имеет тип NS и имеет TTL 1 час (3600 секунд). Он содержит одну запись DNS. Чтобы создать RecordSet с помощью только одной строки pn_PowerShell_short, или создать набор записей с несколькими записями, см. пример 1.

Пример 6. Создание набора записей типа 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

Эта команда создает RecordSet с именем 4 в зоне 3.2.1.in-addr.arpa. Набор записей имеет тип PTR и имеет TTL 1 час (3600 секунд). Он содержит одну запись DNS. Чтобы создать RecordSet с помощью только одной строки pn_PowerShell_short, или создать набор записей с несколькими записями, см. пример 1.

Пример 7. Создание набора записей типа 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

Эта команда создает RecordSet с именем _sip._tcp в зоне myzone.com. Набор записей имеет тип SRV и имеет TTL 1 час (3600 секунд). Он содержит одну запись DNS, указывающую на IP-адрес 2001.2.3.4. Служба (sip) и протокол (tcp) указываются как часть имени набора записей, а не как часть данных записи. Чтобы создать RecordSet с помощью только одной строки pn_PowerShell_short, или создать набор записей с несколькими записями, см. пример 1.

Пример 8. Создание набора записей типа 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

Эта команда создает RecordSet именованный текст в myzone.com зоны. Набор записей имеет тип TXT и имеет TTL 1 час (3600 секунд). Он содержит одну запись DNS. Чтобы создать RecordSet с помощью только одной строки pn_PowerShell_short, или создать набор записей с несколькими записями, см. пример 1.

Пример 9. Создание набора записей в вершине зоны

$Records = @()
$Records += New-AzDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzDnsRecordSet -Name "@" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Эта команда создает RecordSet в вершине (или корень) зоны myzone.com. Для этого имя набора записей указывается как "@" (включая двойные кавычки). Невозможно создать записи CNAME в вершине зоны. Это ограничение стандартов DNS; Это не ограничение Azure DNS. Чтобы создать RecordSet с помощью только одной строки pn_PowerShell_short, или создать набор записей с несколькими записями, см. пример 1.

Пример 10. Создание набора записей подстановочных знаков

$Records = @()
$Records += New-AzDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzDnsRecordSet -Name "*" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Эта команда создает RecordSet с именем * в зоне myzone.com. Это набор подстановочных знаков. Чтобы создать RecordSet с помощью только одной строки pn_PowerShell_short, или создать набор записей с несколькими записями, см. пример 1.

Пример 11. Создание пустого набора записей

$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords @()

Эта команда создает RecordSet www в зоне myzone.com. Набор записей имеет тип A и имеет TTL 1 час (3600 секунд). Это пустой набор записей, который выступает в качестве заполнителя, в который можно позже добавить записи.

Пример 12. Создание набора записей и подавление всех подтверждений

$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

Эта команда создает RecordSet. Параметр Overwrite гарантирует, что этот набор записей перезаписывает любой предварительно существующий набор записей с тем же именем и типом (существующие записи в этом наборе записей будут потеряны). Параметр Подтвердить со значением $False подавляет запрос подтверждения.

Параметры

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DefaultProfile

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

Тип:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DnsRecords

Указывает массив записей DNS для включения в набор записей. Для создания объектов записи DNS можно использовать командлет New-AzDnsRecordConfig. Дополнительные сведения см. в примерах.

Тип:DnsRecordBase[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Metadata

Задает массив метаданных для связывания с Набором записей. Метаданные задаются с помощью пар "имя-значение", которые представляются в виде хэш-таблиц, например @{"dept"="shopping";" env"="production"}.

Тип:Hashtable
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

Указывает имя создаваемого набора записей RecordSet.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Overwrite

Указывает, что этот командлет перезаписывает указанные RecordSet, если он уже существует.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RecordType

Указывает тип создаваемой записи DNS. Допустимые значения:

  • A
  • AAAA
  • CNAME
  • MX
  • NAPTR
  • NS
  • PTR
  • SRV
  • Записи TXT SOA создаются автоматически при создании зоны и не могут быть созданы вручную.
Тип:RecordType
Допустимые значения:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ResourceGroupName

Указывает группу ресурсов, содержащую зону DNS. Чтобы указать имя зоны, необходимо также указать параметр ZoneName. Кроме того, можно указать зону и группу ресурсов, передав объект зоны DNS с помощью параметра зоны .

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-TargetResourceId

Идентификатор целевого ресурса псевдонима.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Ttl

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

Тип:UInt32
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет, если командлет выполняется. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Zone

Указывает DnsZone, в которой создается RecordSet. Кроме того, можно указать зону с помощью параметров zoneName и ResourceGroupName.

Тип:DnsZone
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-ZoneName

Указывает имя зоны, в которой создается RecordSet. Необходимо также указать группу ресурсов, содержащую зону, с помощью параметра ResourceGroupName. Кроме того, можно указать зону и группу ресурсов, передав объект зоны DNS с помощью параметра зоны .

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

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

String

DnsZone

UInt32

RecordType

Hashtable

DnsRecordBase[]

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

DnsRecordSet

Примечания

Вы можете использовать параметр "Подтвердить", чтобы контролировать, запрашивает ли этот командлет подтверждение. По умолчанию командлет запрашивает подтверждение, если переменная Windows PowerShell $ConfirmPreference имеет значение среднего или нижнего. Если указать подтвердить или Confirm:$True, этот командлет запрашивает подтверждение перед выполнением. Если указать Confirm:$False, командлет не запрашивает подтверждение.