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

Set-AzDnsZone

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

Обновляет свойства зоны DNS.

Синтаксис

Set-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-Tag <Hashtable>]
   [-RegistrationVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
   [-ResolutionVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-Tag <Hashtable>]
   [-RegistrationVirtualNetwork <System.Collections.Generic.List`1[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference]>]
   [-ResolutionVirtualNetwork <System.Collections.Generic.List`1[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzDnsZone
   -Zone <DnsZone>
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Командлет Set-AzDnsZone обновляет указанную зону DNS в службе Azure DNS. Этот командлет не обновляет наборы записей в зоне. Можно передать объект DnsZone в качестве параметра или с помощью оператора конвейера или также указать параметры ZoneName и ResourceGroupName . Вы можете использовать параметр "Подтверждение " и $ConfirmPreference переменную Windows PowerShell для управления запросом на подтверждение командлета. При передаче зоны DNS в качестве объекта (с помощью объекта Zone или через конвейер) он не обновляется, если он был изменен в Azure DNS с момента извлечения локального объекта DnsZone. Это обеспечивает защиту одновременных изменений. Это поведение можно отключить с помощью параметра Overwrite , который обновляет зону независимо от одновременных изменений.

Примеры

Пример 1. Обновление зоны DNS

$Zone = Get-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"
$Zone.Tags = @(@{"Name"="Dept"; "Value"="Electrical"})
Set-AzDnsZone -Zone $Zone

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

Пример 2. Обновление тегов для зоны

Set-AzDnsZone -ResourceGroupName "MyResourceGroup" -Name "myzone.com" -Tag @(@{"Name"="Dept"; "Value"="Electrical"})

Эта команда обновляет теги для зоны с именем myzone.com без явного получения зоны.

Пример 3. Связывание частной зоны с виртуальной сетью путем указания его идентификатора

$vnet = Get-AzVirtualNetwork -ResourceGroupName "MyResourceGroup" -Name "myvnet"
Set-AzDnsZone -ResourceGroupName "MyResourceGroup" -Name "myprivatezone.com" -RegistrationVirtualNetworkId @($vnet.Id)

Эта команда связывает зону Частная зона DNS myprivatezone.com с виртуальной сетью myvnet в качестве сети регистрации, указав его идентификатор.

Пример 4. Связывание частной зоны с виртуальной сетью путем указания сетевого объекта.

$vnet = Get-AzVirtualNetwork -ResourceGroupName "MyResourceGroup" -Name "myvnet"
Set-AzDnsZone -ResourceGroupName "MyResourceGroup" -Name "myprivatezone.com" -RegistrationVirtualNetwork @($vnet)

Эта команда связывает зону Частная зона DNS myprivatezone.com с виртуальной сетью myvnet в качестве сети регистрации путем передачи объекта виртуальной сети, представленного переменной $vnet командлету Set-AzDnsZone.

Параметры

-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 для обновления.

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

-Overwrite

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

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

-RegistrationVirtualNetwork

Список виртуальных сетей, которые будут регистрировать записи имен узлов виртуальной машины в этой зоне DNS, доступные только для частных зон.

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

-RegistrationVirtualNetworkId

Список идентификаторов виртуальной сети, которые будут регистрировать записи имен узлов виртуальной машины в этой зоне DNS, доступные только для частных зон.

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

-ResolutionVirtualNetwork

Список виртуальных сетей, способных разрешать записи в этой зоне DNS, доступен только для частных зон.

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

-ResolutionVirtualNetworkId

Список идентификаторов виртуальной сети, способных разрешать записи в этой зоне DNS, доступен только для частных зон.

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

-ResourceGroupName

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

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

-Tag

Пары "ключ-значение" в виде хэш-таблицы. Например: @{key0="value0"; key1=$null; key2="value2"}

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

-WhatIf

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

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

-Zone

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

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

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

String

Hashtable

List<T>[[System.String, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

List<T>[[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference, Microsoft.Azure.PowerShell.Clients.Network, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

DnsZone

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

DnsZone

Примечания

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