Dela via


New-AzDnsRecordSet

Skapar en DNS-postuppsättning.

Syntax

New-AzDnsRecordSet
   -Name <String>
   -ZoneName <String>
   -ResourceGroupName <String>
   -Ttl <UInt32>
   -RecordType <RecordType>
   [-Metadata <Hashtable>]
   [-DnsRecords <DnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDnsRecordSet
   -Name <String>
   -ZoneName <String>
   -ResourceGroupName <String>
   [-Ttl <UInt32>]
   -RecordType <RecordType>
   -TargetResourceId <String>
   [-Metadata <Hashtable>]
   [-DnsRecords <DnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDnsRecordSet
   -Name <String>
   -Zone <DnsZone>
   -Ttl <UInt32>
   -RecordType <RecordType>
   [-Metadata <Hashtable>]
   [-DnsRecords <DnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDnsRecordSet
   -Name <String>
   -Zone <DnsZone>
   [-Ttl <UInt32>]
   -RecordType <RecordType>
   -TargetResourceId <String>
   [-Metadata <Hashtable>]
   [-DnsRecords <DnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cmdleten New-AzDnsRecordSet skapar en ny DNS-postuppsättning (Domain Name System) med det angivna namnet och skriver i den angivna zonen. Ett RecordSet-objekt är en uppsättning DNS-poster med samma namn och typ. Observera att namnet är relativt till zonen och inte det fullständigt kvalificerade namnet. Parametern DnsRecords anger posterna i postuppsättningen. Den här parametern tar en matris med DNS-poster som konstruerats med New-AzDnsRecordConfig. Du kan använda pipelineoperatorn för att skicka ett DnsZone-objekt till den här cmdleten, eller så kan du skicka ett DnsZone-objekt som zonparameter , eller så kan du ange zonen efter namn. Du kan använda parametern Confirm och $ConfirmPreference Windows PowerShell för att kontrollera om cmdleten ber dig om bekräftelse. Om det redan finns en matchande RecordSet (samma namn och posttyp) måste du ange parametern Skriv över , annars skapar cmdleten inte en ny RecordSet .

Exempel

Exempel 1: Skapa en postuppsättning av typen A

$Records = @()
$Records += New-AzDnsRecordConfig -IPv4Address 1.2.3.4
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

# When creating a RecordSet containing a single record, the above sequence can also be condensed into a single line:

$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords (New-AzDnsRecordConfig -IPv4Address 1.2.3.4)

# To create a record set containing multiple records, use New-AzDnsRecordConfig to add each record to the $Records array,
# then call New-AzDnsRecordSet, as follows:

$Records = @()
$Records += New-AzDnsRecordConfig -IPv4Address 1.2.3.4
$Records += New-AzDnsRecordConfig -IPv4Address 5.6.7.8
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

I det här exemplet skapas en RecordSet med namnet www i zonen myzone.com. Postuppsättningen är av typ A och har en TTL på 1 timme (3 600 sekunder). Den innehåller en enda DNS-post.

Exempel 2: Skapa en postuppsättning av typen AAAA

$Records = @()
$Records += New-AzDnsRecordConfig -Ipv6Address 2001:db8::1
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

I det här exemplet skapas en RecordSet med namnet www i zonen myzone.com. Postuppsättningen är av typen AAAA och har en TTL på 1 timme (3 600 sekunder). Den innehåller en enda DNS-post. Information om hur du skapar en RecordSet med bara en rad pn_PowerShell_short eller för att skapa en postuppsättning med flera poster finns i Exempel 1.

Exempel 3: Skapa en postuppsättning av typen CNAME

$Records = @()
$Records += New-AzDnsRecordConfig -Cname www.contoso.com
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

I det här exemplet skapas en RecordSet med namnet www i zonen myzone.com. Postuppsättningen är av typen CNAME och har en TTL på 1 timme (3 600 sekunder). Den innehåller en enda DNS-post. Information om hur du skapar en RecordSet med bara en rad pn_PowerShell_short eller för att skapa en postuppsättning med flera poster finns i Exempel 1.

Exempel 4: Skapa en postuppsättning av typen MX

$Records = @()
$Records += New-AzDnsRecordConfig -Exchange "mail.microsoft.com" -Preference 5
$RecordSet = New-AzDnsRecordSet -Name "mail" -RecordType MX -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Det här kommandot skapar en RecordSet med namnet www i zonen myzone.com. Postuppsättningen är av typen MX och har en TTL på 1 timme (3 600 sekunder). Den innehåller en enda DNS-post. Information om hur du skapar en RecordSet med bara en rad pn_PowerShell_short eller för att skapa en postuppsättning med flera poster finns i Exempel 1.

Exempel 5: Skapa en postuppsättning av typen NS

$Records = @()
$Records += New-AzDnsRecordConfig -Nsdname ns1-01.azure-dns.com
$RecordSet = New-AzDnsRecordSet -Name "ns1" -RecordType NS -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Det här kommandot skapar en RecordSet med namnet ns1 i zonen myzone.com. Postuppsättningen är av typen NS och har en TTL på 1 timme (3 600 sekunder). Den innehåller en enda DNS-post. Information om hur du skapar en RecordSet med bara en rad pn_PowerShell_short eller för att skapa en postuppsättning med flera poster finns i Exempel 1.

Exempel 6: Skapa en postuppsättning av typen PTR

$Records = @()
$Records += New-AzDnsRecordConfig -Ptrdname www.contoso.com
$RecordSet = New-AzDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "3.2.1.in-addr.arpa" -DnsRecords $Records

Det här kommandot skapar en RecordSet med namnet 4 i zonen 3.2.1.in-addr.arpa. Postuppsättningen är av typen PTR och har en TTL på 1 timme (3 600 sekunder). Den innehåller en enda DNS-post. Information om hur du skapar en RecordSet med bara en rad pn_PowerShell_short eller för att skapa en postuppsättning med flera poster finns i Exempel 1.

Exempel 7: Skapa en postuppsättning av typen SRV

$Records = @()
$Records += New-AzDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target sipservice.contoso.com
$RecordSet = New-AzDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Det här kommandot skapar en RecordSet med namnet _sip._tcp i zonen myzone.com. Postuppsättningen är av typen SRV och har en TTL på 1 timme (3 600 sekunder). Den innehåller en enda DNS-post som pekar på IP-adressen 2001.2.3.4. Tjänsten (sip) och protokollet (tcp) anges som en del av postuppsättningens namn, inte som en del av postdata. Information om hur du skapar en RecordSet med bara en rad pn_PowerShell_short eller för att skapa en postuppsättning med flera poster finns i Exempel 1.

Exempel 8: Skapa en postuppsättning av typen TXT

$Records = @()
$Records += New-AzDnsRecordConfig -Value "This is a TXT Record"
$RecordSet = New-AzDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Det här kommandot skapar en RecordSet med namnet text i zonen myzone.com. Postuppsättningen är av typen TXT och har en TTL på 1 timme (3 600 sekunder). Den innehåller en enda DNS-post. Information om hur du skapar en RecordSet med bara en rad pn_PowerShell_short eller för att skapa en postuppsättning med flera poster finns i Exempel 1.

Exempel 9: Skapa en postuppsättning i zonexemplet

$Records = @()
$Records += New-AzDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzDnsRecordSet -Name "@" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Det här kommandot skapar en RecordSet i toppen (eller roten) i zonen myzone.com. För att göra detta anges postuppsättningens namn som "@" (inklusive dubbla citattecken). Du kan inte skapa CNAME-poster i toppen av en zon. Detta är en begränsning av DNS-standarderna. det är inte en begränsning för Azure DNS. Information om hur du skapar en RecordSet med bara en rad pn_PowerShell_short eller för att skapa en postuppsättning med flera poster finns i Exempel 1.

Exempel 10: Skapa en postuppsättning med jokertecken

$Records = @()
$Records += New-AzDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzDnsRecordSet -Name "*" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

Det här kommandot skapar en RecordSet med namnet * i zonen myzone.com. Det här är en postuppsättning med jokertecken. Information om hur du skapar en RecordSet med bara en rad pn_PowerShell_short eller för att skapa en postuppsättning med flera poster finns i Exempel 1.

Exempel 11: Skapa en tom postuppsättning

$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords @()

Det här kommandot skapar en RecordSet med namnet www i zonen myzone.com. Postuppsättningen är av typ A och har en TTL på 1 timme (3 600 sekunder). Det här är en tom postuppsättning som fungerar som en platshållare som du senare kan lägga till poster till.

Exempel 12: Skapa en postuppsättning och ignorera all bekräftelse

$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords (New-AzDnsRecordConfig -Ipv4Address 1.2.3.4) -Confirm:$False -Overwrite

Det här kommandot skapar en RecordSet. Parametern Överskrivning säkerställer att den här postuppsättningen skriver över alla befintliga postuppsättningar med samma namn och typ (befintliga poster i den postuppsättningen går förlorade). Parametern Bekräfta med värdet $False undertrycker bekräftelseprompten.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure

Typ:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DnsRecords

Anger matrisen med DNS-poster som ska inkluderas i postuppsättningen. Du kan använda cmdleten New-AzDnsRecordConfig för att skapa DNS-postobjekt. Mer information finns i exemplen.

Typ:DnsRecordBase[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Metadata

Anger en matris med metadata som ska associeras med RecordSet. Metadata anges med namn/värde-par som representeras som hash-tabeller, till exempel @{"dept"="shopping";" env"="production"}.

Typ:Hashtable
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Anger namnet på den RecordSet som ska skapas.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Overwrite

Anger att den här cmdleten skriver över den angivna RecordSet om den redan finns.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RecordType

Anger vilken typ av DNS-post som ska skapas. Giltiga värden är:

  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • PTR
  • SRV
  • TXT SOA-poster skapas automatiskt när zonen skapas och kan inte skapas manuellt.
Typ:RecordType
Godkända värden:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResourceGroupName

Anger den resursgrupp som innehåller DNS-zonen. Du måste också ange parametern ZoneName för att ange zonnamnet. Du kan också ange zonen och resursgruppen genom att skicka in ett DNS-zonobjekt med hjälp av parametern Zon .

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-TargetResourceId

Resurs-ID för aliasmål.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Ttl

Anger TTL (Time to Live) för DNS RecordSet.

Typ:UInt32
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Zone

Anger i vilken DnsZone postuppsättningen ska skapas. Du kan också ange zonen med parametrarna ZoneName och ResourceGroupName .

Typ:DnsZone
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ZoneName

Anger namnet på zonen där postuppsättningen ska skapas. Du måste också ange den resursgrupp som innehåller zonen med parametern ResourceGroupName . Du kan också ange zonen och resursgruppen genom att skicka in ett DNS-zonobjekt med hjälp av parametern Zon .

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

String

DnsZone

UInt32

RecordType

Hashtable

DnsRecordBase[]

Utdata

DnsRecordSet

Kommentarer

Du kan använda parametern Bekräfta för att kontrollera om den här cmdleten uppmanar dig att bekräfta. Som standard uppmanar cmdleten dig att bekräfta om $ConfirmPreference Windows PowerShell-variabeln har värdet Medel eller lägre. Om du anger Bekräfta eller Bekräfta:$True uppmanas du att bekräfta den här cmdleten innan den körs. Om du anger Confirm:$False uppmanas du inte att bekräfta cmdleten.