search

IT-Service / ITG.Yandex.DnsServer

Модуль, предлагающий командлеты по аналогии с модулем DnsServer, но для DNS серверов Яндекс
2 stars 1 forks source link

readme

ITG.Yandex.DnsServer

Обёртки для API Яндекс DNS для домена (pdd.yandex.ru) и командлеты на их основе. Модуль предназначен для обеспечения той же функциональности, что и модуль DNSServer из комплекта Windows Server 2012, но на базе DNS серверов Яндекса (естественно, с ограничениями), интерфейс максимально приближен к интерфейсу командлет модуля DNSServer.

Версия модуля: 2.2.0

Функции модуля

DnsServerResourceRecord

Обзор Add-DnsServerResourceRecord

Метод (обёртка над Яндекс.API add_a_record) предназначен для создания новой записи на "припаркованном" на Яндексе домене на основе данных о записи из конвейера.

Add-DnsServerResourceRecord [-ZoneName] <String> [[-Name] <String>] [-RRType] <String> [[-RecordData] <String>] [[-TimeToLive] <Object>] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>

Подробнее - Add-DnsServerResourceRecord.

Обзор Get-DnsServerResourceRecord

Метод (обёртка над Яндекс.API get_domain_records) предназначен для получения записей из зоны "припаркованного" на Яндексе домене.

Get-DnsServerResourceRecord [-ZoneName] <String> [[-Name] <String[]>] [[-RRType] <String[]>] [[-RecordData] <String[]>] <CommonParameters>

Подробнее - Get-DnsServerResourceRecord.

Обзор Remove-DnsServerResourceRecord

Метод (обёртка над Яндекс.API delete_record) предназначен для удаления записи из зоны "припаркованного" на Яндексе домене.

Remove-DnsServerResourceRecord [-ZoneName] <String> [-Name] <String> [[-RRType] <String>] [[-RecordData] <String[]>] [[-id] <String>] [-PassThru] [-Force] [-WhatIf] [-Confirm] <CommonParameters>

Подробнее - Remove-DnsServerResourceRecord.

DnsServerResourceRecordA

Обзор Add-DnsServerResourceRecordA

Метод (обёртка над Яндекс.API add_a_record) предназначен для создания новой записи типа A на "припаркованном" на Яндексе домене.

Add-DnsServerResourceRecordA [-ZoneName] <String> [[-Name] <String>] [-IPv4Address] <IPAddress[]> [[-TimeToLive] <Object>] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>

Подробнее - Add-DnsServerResourceRecordA.

DnsServerResourceRecordAAAA

Обзор Add-DnsServerResourceRecordAAAA

Метод (обёртка над Яндекс.API add_aaaa_record) предназначен для создания новой записи типа AAAA на "припаркованном" на Яндексе домене.

Add-DnsServerResourceRecordAAAA [-ZoneName] <String> [[-Name] <String>] [-IPv6Address] <IPAddress[]> [[-TimeToLive] <Object>] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>

Подробнее - Add-DnsServerResourceRecordAAAA.

DnsServerResourceRecordCName

Обзор Add-DnsServerResourceRecordCName

Метод (обёртка над Яндекс.API add_cname_record) предназначен для создания новой записи типа CNAME на "припаркованном" на Яндексе домене.

Add-DnsServerResourceRecordCName [-ZoneName] <String> [-Name] <String> [-HostAliasName] <String> [[-TimeToLive] <Object>] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>

Подробнее - Add-DnsServerResourceRecordCName.

DnsServerResourceRecordMX

Обзор Add-DnsServerResourceRecordMX

Метод (обёртка над Яндекс.API add_mx_record) предназначен для создания новой записи типа MX на "припаркованном" на Яндексе домене.

Add-DnsServerResourceRecordMX [-ZoneName] <String> [[-Name] <String>] [-MailExchange] <String> [[-Preference] <UInt16>] [[-TimeToLive] <Object>] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>

Подробнее - Add-DnsServerResourceRecordMX.

DnsServerResourceRecordNS

Обзор Add-DnsServerResourceRecordNS

Метод (обёртка над Яндекс.API add_ns_record) предназначен для создания новой записи типа NS на "припаркованном" на Яндексе домене.

Add-DnsServerResourceRecordNS [-ZoneName] <String> [[-Name] <String>] [-NameServer] <String[]> [[-TimeToLive] <Object>] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>

Подробнее - Add-DnsServerResourceRecordNS.

DnsServerResourceRecordSRV

Обзор Add-DnsServerResourceRecordSRV

Метод (обёртка над Яндекс.API add_srv_record) предназначен для создания новой SRV записи на "припаркованном" на Яндексе домене.

Add-DnsServerResourceRecordSRV [-ZoneName] <String> [-Name] <String> [-Server] <String> [-Port] <UInt16> [[-Preference] <UInt16>] [[-Weight] <UInt16>] [[-TimeToLive] <Object>] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>

Подробнее - Add-DnsServerResourceRecordSRV.

DnsServerResourceRecordTxt

Обзор Add-DnsServerResourceRecordTxt

Метод (обёртка над Яндекс.API add_txt_record) предназначен для создания новой записи типа TXT на "припаркованном" на Яндексе домене.

Add-DnsServerResourceRecordTxt [-ZoneName] <String> [[-Name] <String>] [-DescriptiveText] <String[]> [[-TimeToLive] <Object>] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>

Подробнее - Add-DnsServerResourceRecordTxt.

Подробное описание функций модуля

Add-DnsServerResourceRecord

Метод (обёртка над Яндекс.API add_a_record) предназначен для создания новой записи на "припаркованном" на Яндексе домене на основе данных о записи из конвейера. Параметры в этом командлете не привязаны к конвейеру сознательно: привязка будет осуществлена в вызываемом в зависимости от типа записи командлете. Здесь же в параметрах следует видеть только явно заданные параметры. Интерфейс командлета максимально приближен к аналогичному командлету модуля DnsServer Windows Server 2012.

Синтаксис
Add-DnsServerResourceRecord [-ZoneName] <String> [[-Name] <String>] [-RRType] <String> [[-RecordData] <String>] [[-TimeToLive] <Object>] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>
Компонент

API Яндекс.DNS для доменов

Параметры
Примеры использования

  1. "Копирование" всех записей типа A, AAAA, CNAME из локальной зоны DNS в публичную зону DNS, размещённую на серверах Яндекса.

    Get-DnsServerResourceRecord -ZoneName 'csm.nov.local' -RRType 'A','CNAME','AAAA' | Add-YandexDnsServerResourceRecord -ZoneName 'csm.nov.ru';

Get-DnsServerResourceRecord

Метод (обёртка над Яндекс.API get_domain_records) предназначен для получения записей из зоны "припаркованного" на Яндексе домене. Интерфейс командлета максимально приближен к аналогичному командлету модуля DnsServer Windows Server 2012. Все функции данного модуля используют ITG.Yandex, в частности - Get-Token.

Синтаксис
Get-DnsServerResourceRecord [-ZoneName] <String> [[-Name] <String[]>] [[-RRType] <String[]>] [[-RecordData] <String[]>] <CommonParameters>
Компонент

API Яндекс.DNS для доменов

Параметры
Примеры использования

  1. Пример 1.

    Get-DnsServerResourceRecord -ZoneName 'csm.nov.ru';
См. также

Remove-DnsServerResourceRecord

Метод (обёртка над Яндекс.API delete_record) предназначен для удаления записи из зоны "припаркованного" на Яндексе домене. Интерфейс командлета максимально приближен к аналогичному командлету модуля DnsServer Windows Server 2012.

Синтаксис
Remove-DnsServerResourceRecord [-ZoneName] <String> [-Name] <String> [[-RRType] <String>] [[-RecordData] <String[]>] [[-id] <String>] [-PassThru] [-Force] [-WhatIf] [-Confirm] <CommonParameters>
Компонент

API Яндекс.DNS для доменов

Параметры
Примеры использования

  1. Пример 1.

    Get-DnsServerResourceRecord -ZoneName 'csm.nov.ru' -Name 'www2','www3' | Remove-DnsServerResourceRecord -ZoneName 'csm.nov.ru';
См. также

Add-DnsServerResourceRecordA

Метод (обёртка над Яндекс.API add_a_record) предназначен для создания новой записи типа A на "припаркованном" на Яндексе домене. Интерфейс командлета максимально приближен к аналогичному командлету модуля DnsServer Windows Server 2012.

Синтаксис
Add-DnsServerResourceRecordA [-ZoneName] <String> [[-Name] <String>] [-IPv4Address] <IPAddress[]> [[-TimeToLive] <Object>] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>
Компонент

API Яндекс.DNS для доменов

Параметры
Примеры использования

  1. Пример 1.

    Add-DnsServerResourceRecordA -ZoneName 'csm.nov.ru' -Name 'www2' -IPv4Address '172.31.0.8', '172.31.0.7' -TimeToLive 55 ;
См. также

Add-DnsServerResourceRecordAAAA

Метод (обёртка над Яндекс.API add_aaaa_record) предназначен для создания новой записи типа AAAA на "припаркованном" на Яндексе домене. Интерфейс командлета максимально приближен к аналогичному командлету модуля DnsServer Windows Server 2012.

Синтаксис
Add-DnsServerResourceRecordAAAA [-ZoneName] <String> [[-Name] <String>] [-IPv6Address] <IPAddress[]> [[-TimeToLive] <Object>] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>
Компонент

API Яндекс.DNS для доменов

Параметры
Примеры использования

  1. Пример 1.

    Add-DnsServerResourceRecordAAAA -ZoneName 'csm.nov.ru' -Name 'www2' -IPv6Address '::1';
См. также

Add-DnsServerResourceRecordCName

Метод (обёртка над Яндекс.API add_cname_record) предназначен для создания новой записи типа A на "припаркованном" на Яндексе домене. Интерфейс командлета максимально приближен к аналогичному командлету модуля DnsServer Windows Server 2012. Есть некоторая особенность в API Яндекса - он позволяет создавать CName только для FQDN. Другими словами, создать "короткий" CName со ссылкой на запись того же домена нельзя, только через FQDN. Данная функция проверяет значение параметра Name и в том случае, если в конце не . (то есть - не FQDN), к значению предварительно дописывает ZoneName + .. Введён данный функционал для обеспечения совместимости с командлетами DnsServer.

Синтаксис
Add-DnsServerResourceRecordCName [-ZoneName] <String> [-Name] <String> [-HostAliasName] <String> [[-TimeToLive] <Object>] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>
Компонент

API Яндекс.DNS для доменов

Параметры
Примеры использования

  1. Создаём CName www2 как псевдоним к http://www.csm.nov.ru.

    Add-DnsServerResourceRecordCName -ZoneName 'csm.nov.ru' -Name 'www2' -HostAliasName 'www';
См. также

Add-DnsServerResourceRecordMX

Метод (обёртка над Яндекс.API add_mx_record) предназначен для создания новой записи типа MX на "припаркованном" на Яндексе домене. Интерфейс командлета максимально приближен к аналогичному командлету модуля DnsServer Windows Server 2012. В описании API на Яндексе закралась ошибка. API принимает и параметр priority.

Синтаксис
Add-DnsServerResourceRecordMX [-ZoneName] <String> [[-Name] <String>] [-MailExchange] <String> [[-Preference] <UInt16>] [[-TimeToLive] <Object>] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>
Компонент

API Яндекс.DNS для доменов

Параметры
Примеры использования

  1. Создаём MX запись в домене csm.nov.ru.

    Add-DnsServerResourceRecordMX -ZoneName 'csm.nov.ru' -MailExchange 'mx.yandex.ru.';
См. также

Add-DnsServerResourceRecordNS

Метод (обёртка над Яндекс.API add_ns_record) предназначен для создания новой записи типа NS на "припаркованном" на Яндексе домене. Интерфейс командлета максимально приближен к аналогичному командлету модуля DnsServer Windows Server 2012.

Синтаксис
Add-DnsServerResourceRecordNS [-ZoneName] <String> [[-Name] <String>] [-NameServer] <String[]> [[-TimeToLive] <Object>] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>
Компонент

API Яндекс.DNS для доменов

Параметры
Примеры использования

  1. Создаём поддомен support в домене csm.nov.ru и указываем, что зона для этого поддомена поддерживается сервером ns.csm.nov.ru.

    Add-DnsServerResourceRecordNS -ZoneName 'csm.nov.ru' -Name 'support' -NameServer 'ns.csm.nov.ru.';
См. также

Add-DnsServerResourceRecordSRV

Метод (обёртка над Яндекс.API add_srv_record) предназначен для создания новой SRV записи на "припаркованном" на Яндексе домене. Интерфейс командлета максимально приближен к аналогичному командлету модуля DnsServer Windows Server 2012.

To-Do: обнаружил ошибку в API: при создании SRV записи через API Яндекса возникает ещё одна "фантомная" запись с тем же содержанием, но в состоянии "добавляется". И так и висит. Удалить её нет возможности...

Синтаксис
Add-DnsServerResourceRecordSRV [-ZoneName] <String> [-Name] <String> [-Server] <String> [-Port] <UInt16> [[-Preference] <UInt16>] [[-Weight] <UInt16>] [[-TimeToLive] <Object>] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>
Компонент

API Яндекс.DNS для доменов

Параметры
Примеры использования

  1. Создаём SRV запись в домене csm.nov.ru.

    Add-DnsServerResourceRecordSRV -ZoneName 'csm.nov.ru' -Name '_xmpp-server._tcp' -Server 'xmpp' -Port 5269 -Weight 0 -Priority 40;

  2. Копируем SRV записи, описывающие XMPP (Jabber) сервис, с одного домена в другой.

    Get-DnsServerResourceRecord -ZoneName 'csm.nov.ru' -RRType 'SRV' | ? { $_.HostName -like '*xmpp*' } | Add-DnsServerResourceRecord -ZoneName 'nice-tour.nov.ru';
См. также

Add-DnsServerResourceRecordTxt

Метод (обёртка над Яндекс.API add_txt_record) предназначен для создания новой записи типа TXT на "припаркованном" на Яндексе домене. Интерфейс командлета максимально приближен к аналогичному командлету модуля DnsServer Windows Server 2012.

Синтаксис
Add-DnsServerResourceRecordTxt [-ZoneName] <String> [[-Name] <String>] [-DescriptiveText] <String[]> [[-TimeToLive] <Object>] [-PassThru] [-WhatIf] [-Confirm] <CommonParameters>
Компонент

API Яндекс.DNS для доменов

Параметры
Примеры использования

  1. Пример 1.

    Add-DnsServerResourceRecordTxt -ZoneName 'csm.nov.ru' -Name 'hostmaster' -Text 'IT department of CSM of Velikiy Novgorod. Sergey S. Betke.';
См. также

Генератор: ITG.Readme.