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

Get-AzureRmDnsRecordSet

创建 DNS 记录集。

警告

截至 2024 年 2 月 29 日,AzureRM PowerShell 模块已正式弃用。 为了确保持续获得支持和更新,建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可能正常运行,但它不再维护或受支持,但会根据用户的自由裁量权和风险继续使用任何继续使用模块。 有关过渡到 Az 模块的指导,请参阅我们的迁移资源

语法

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 对象作为 Zone 参数传递,或者也可以按名称指定区域和资源组。

示例

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

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

此命令获取指定资源组和区域中名为 www 的记录类型的记录集,然后将其存储在$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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

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

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

-Zone

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

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

-ZoneName

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

Type:String
Position:Named
Default value:None
Required:True
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