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

Remove-AzDnsRecordSet

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

Удаляет набор записей.

Синтаксис

Remove-AzDnsRecordSet
      -Name <String>
      -RecordType <RecordType>
      -ZoneName <String>
      -ResourceGroupName <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzDnsRecordSet
      -Name <String>
      -RecordType <RecordType>
      -Zone <DnsZone>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzDnsRecordSet
      -RecordSet <DnsRecordSet>
      [-Overwrite]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Командлет Remove-AzDnsRecordSet удаляет указанный набор записей из указанной зоны. Вы не можете удалить записи SOA или сервера имен (NS), которые автоматически создаются на вершине зоны. Вы можете передать объект RecordSet в этот командлет с помощью оператора конвейера или в качестве параметра. Чтобы определить набор записей по имени и типу без использования объекта recordSet RecordSet, необходимо передать зону в качестве объекта DnsZone в этот командлет с помощью оператора конвейера или в качестве параметра или также можно указать параметры ZoneName и ResourceGroupName. Вы можете использовать параметр "Подтверждение" и $ConfirmPreference переменную Windows PowerShell для управления запросом на подтверждение командлета. При указании набора записей с помощью объекта RecordSet набор записей не удаляется, если он был изменен в Azure DNS с момента получения локального объекта recordSet RecordSet. Это обеспечивает защиту одновременных изменений. Это можно отключить с помощью параметра Overwrite, который удаляет набор записей независимо от одновременных изменений.

Примеры

Пример 1. Удаление набора записей

$RecordSet = Get-AzDnsRecordSet -Name "www" -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"
Remove-AzDnsRecordSet -RecordSet $RecordSet

Первая команда получает указанный набор записей, а затем сохраняет его в переменной $RecordSet. Вторая команда удаляет набор записей в $RecordSet.

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

$RecordSet = Get-AzDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup"
Remove-AzDnsRecordSet -RecordSet $RecordSet -Confirm:$False -Overwrite

# Alternatively, the record set can be removed as follows.  In this case,
# because the record set is specified by name rather than by object, the
# Overwrite parameter is not applicable.

Remove-AzDnsRecordSet -Name "www" -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup" -Confirm:$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

-Name

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

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

-Overwrite

При указании набора записей с помощью объекта RecordSet набор записей не удаляется, если он был изменен в Azure DNS с момента получения локального объекта recordSet RecordSet. Это обеспечивает защиту одновременных изменений. Это можно отключить с помощью параметра Overwrite, который удаляет набор записей независимо от одновременных изменений.

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

-PassThru

passthru

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

-RecordSet

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

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

-RecordType

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

  • A
  • AAAA
  • CNAME
  • MX
  • NAPTR
  • NS
  • PTR
  • SRV
  • Записи TXT SOA удаляются автоматически при удалении зоны. Невозможно вручную удалить записи 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, содержащую Набор записей, для удаления. Этот параметр применим, только если задан набор записей и зона DNS с помощью параметров имени и ZoneName. Кроме того, можно указать набор записей с помощью параметра RecordSet или параметра Name и Zone.

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

-WhatIf

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

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

-Zone

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

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

-ZoneName

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

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

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

RecordType

String

DnsZone

DnsRecordSet

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

Boolean

Примечания

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