Remove-AzDnsRecordSet
Удаляет набор записей.
Синтаксис
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 |
Входные данные
Выходные данные
Примечания
Вы можете использовать параметр "Подтвердить", чтобы контролировать, запрашивает ли этот командлет подтверждение. По умолчанию командлет запрашивает подтверждение, если переменная Windows PowerShell $ConfirmPreference имеет значение среднего или нижнего. Если указать подтверждение или подтверждение:$True, этот командлет запрашивает подтверждение перед выполнением. Если указать подтверждение:$False, командлет не запрашивает подтверждение.