你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Get-AzureRmDnsRecordSet

创建 DNS 记录集。

重要

由于 Az PowerShell 模块现在已具有 AzureRM PowerShell 模块的所有功能及更多功能,因此我们将于 2024 年 2 月 29 日停用 AzureRM PowerShell 模块。

若要避免服务中断,请更新脚本,在 2024 年 2 月 29 日结束之前将使用 AzureRM PowerShell 模块的脚本更新为使用 Az PowerShell 模块。 若要自动更新脚本,请按照快速入门指南操作。

语法

Get-AzureRmDnsRecordSet
   [-Name <String>]
   -ZoneName <String>
   -ResourceGroupName <String>
   [-RecordType <RecordType>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmDnsRecordSet
   [-Name <String>]
   -Zone <DnsZone>
   [-RecordType <RecordType>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

Get-AzureRmDnsRecordSet cmdlet 获取指定区域中具有指定名称和类型的域名系统 (DNS) 记录集。 如果未指定 NameRecordType 参数,此 cmdlet 将返回区域中指定类型的所有记录集。 如果指定 RecordType 参数而不是 Name 参数,则此 cmdlet 将返回指定记录类型的所有记录集。 可以使用管道运算符将 DnsZone 对象传递给此 cmdlet,也可以将 DnsZone 对象作为 区域 参数传递,或者也可以按名称指定区域和资源组。

示例

示例 1:获取具有指定名称和类型的记录集

PS C:\>$RecordSet = Get-AzureRmDnsRecordSet -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" -Name "www" -RecordType A

此命令获取指定资源组和区域中名为 www 的记录类型 A 的记录集,然后将其存储在$RecordSet变量中。 由于指定 了 NameRecordType 参数,因此只返回一个 RecordSet 对象。

示例 2:获取指定类型的记录集

PS C:\>$RecordSets = Get-AzureRmDnsRecordSet -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" -RecordType A

此命令获取名为 MyResourceGroup 的资源组中名为 myzone.com 的区域中记录类型 A 的所有记录集的数组,然后将其存储在$RecordSets变量中。

示例 3:获取区域中的所有记录集

PS C:\>$RecordSets = Get-AzureRmDnsRecordSet -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"

此命令获取名为 MyResourceGroup 的资源组中名为 myzone.com 的区域中的所有记录集的数组,然后将其存储在$RecordSets变量中。

示例 4:使用 DnsZone 对象获取区域中的所有记录集

PS C:\> $Zone = Get-AzureRmDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"
PS C:\> $RecordSets = Get-AzureRmDnsRecordSet -Zone $Zone

此示例等效于上面的示例 3。 这一次,使用区域对象指定区域。

参数

-DefaultProfile

用于与 azure 通信的凭据、帐户、租户和订阅

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Name

指定要获取的 RecordSet 的名称。 如果未指定 Name 参数,则返回指定类型的所有记录集。

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-RecordType

指定此 cmdlet 获取的 DNS 记录的类型。 有效值是:

  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • PTR
  • SOA
  • SRV
  • TXT 如果未指定 RecordType 参数,则还必须省略 Name 参数。 然后,此 cmdlet 返回所有名称和类型) 区域 (中的所有记录集。
Type:Nullable<T>[RecordType]
Accepted values:A, AAAA, CAA, CNAME, MX, NS, PTR, SOA, SRV, TXT
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

指定包含 DNS 区域的资源组。 还必须使用 ZoneName 参数指定区域名称。 或者,可以使用 Zone 参数传入 DnsZone 对象来指定区域和资源组。

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Zone

指定包含此 cmdlet 获取的记录集的 DNS 区域。 或者,可以使用 ZoneNameResourceGroupName 参数指定区域。

Type:DnsZone
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-ZoneName

指定要获取的记录集的 DNS 区域的名称。 还必须使用 ResourceGroupName 参数指定包含区域的资源组。 或者,可以使用 Zone 参数传入 DNS 区域对象来指定区域和资源组。

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

输入

String

DnsZone

参数:区域 (ByValue)

Nullable<T>[[Microsoft.Azure.Management.Dns.Models.RecordType, Microsoft.Azure.Management.Dns, Version=2.1.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

输出

DnsRecordSet