Get-AzDnsRecordSet

  • リファレンス
モジュール:
Az.Dns

DNS レコード セットを取得します。

構文

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

説明

Get-AzDnsRecordSet コマンドレットは、指定したゾーンで、指定した名前と種類を持つ Doメイン Name System (DNS) レコード セットを取得します。 Name パラメーターまたは RecordType パラメーターを指定しない場合、このコマンドレットはゾーン内の指定した型のすべてのレコード セットを返します。 RecordType パラメーターを指定しても Name パラメーターを指定しない場合、このコマンドレットは指定したレコード型のすべてのレコード セットを返します。 パイプライン演算子を使用して、このコマンドレットに DnsZone オブジェクトを渡すか、ゾーン パラメーターとして DnsZone オブジェクトを渡すか、またはゾーンとリソース グループを名前で指定することもできます。

例

例 1: 指定した名前と種類のレコード セットを取得する

$RecordSet = Get-AzDnsRecordSet -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" -Name "www" -RecordType A

このコマンドは、指定したリソース グループとゾーン内の www という名前のレコード タイプ A のレコード セットを取得し、$RecordSet変数に格納します。 Name パラメーターと RecordType パラメーターが指定されているため、1 つの RecordSet オブジェクトのみが返されます。

例 2: 指定した型のレコード セットを取得する

$RecordSets = Get-AzDnsRecordSet -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com" -RecordType A

このコマンドは、MyResourceGroup という名前のリソース グループ内の myzone.com というゾーン内のレコード型 A のすべてのレコード セットの配列を取得し、$RecordSets変数に格納します。

例 3: ゾーン内のすべてのレコード セットを取得する

$RecordSets = Get-AzDnsRecordSet -ResourceGroupName "MyResourceGroup" -ZoneName "myzone.com"

このコマンドは、MyResourceGroup という名前のリソース グループ内の myzone.com というゾーン内のすべてのレコード セットの配列を取得し、それらを $RecordSets 変数に格納します。

例 4: DnsZone オブジェクトを使用してゾーン内のすべてのレコード セットを取得する

$Zone = Get-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"
$RecordSets = Get-AzDnsRecordSet -Zone $Zone

この例は、上記の例 3 と同じです。 今回は、ゾーン オブジェクトを使用してゾーンを指定します。

パラメーター

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション

Type:IAzureContextContainer
Aliases:AzContext, 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

このコマンドレットが取得する DNS レコードの種類を指定します。 有効な値は次の通りです。

  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • PTR
  • SOA
  • SRV
  • TXT RecordType パラメーターを指定しない場合は、Name パラメーターも省略する必要があります。 このコマンドレットは、ゾーン内のすべてのレコード セット (すべての名前と型) を返します。
Type:Nullable<T>[RecordType]
Accepted values:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
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

このコマンドレットが取得するレコード セットを含む 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 ゾーン オブジェクトを渡すことによって、ゾーンとリソース グループを指定することもできます。

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

入力

String

DnsZone

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

出力

DnsRecordSet