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

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 , необходимо передать зону в качестве объекта DnsZone в этот командлет с помощью оператора конвейера или в качестве параметра или также можно указать параметры ZoneName и ResourceGroupName . Вы можете использовать параметр "Подтверждение" и $ConfirmPreference переменную Windows PowerShell для управления запросом на подтверждение командлета. При указании набора записей с помощью объекта RecordSet набор записей не удаляется, если он был изменен в Azure DNS с момента извлечения локального объекта 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

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

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

-Overwrite

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

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

-PassThru

passthru

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

-RecordSet

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

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

-RecordType

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

  • а
  • AAAA;
  • CNAME
  • MX
  • 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 указываются с помощью параметров Name и 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, содержащую набор записей для удаления. Этот параметр применим только при указании набора записей с помощью параметра Name . Кроме того, можно указать набор записей с помощью параметра RecordSet или параметров Name, ZoneName и ResourceGroupName .

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

-ZoneName

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

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

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

RecordType

String

DnsZone

DnsRecordSet

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

Boolean

Примечания

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