Sdílet prostřednictvím

New-AzDnsRecordSet

  • Reference
Modul:
Az.Dns

Vytvoří sadu záznamů DNS.

Syntaxe

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

Rutina New-AzDnsRecordSet vytvoří novou sadu záznamů DNS (Domain Name System) se zadaným názvem a typem v zadané zóně. Objekt RecordSet je sada záznamů DNS se stejným názvem a typem. Všimněte si, že název je relativní vzhledem k zóně, nikoli plně kvalifikovaný název. Parametr DnsRecords určuje záznamy v sadě záznamů. Tento parametr přebírá pole záznamů DNS vytvořené pomocí New-AzDnsRecordConfig. Operátor kanálu můžete použít k předání objektu DnsZone této rutiny, nebo můžete předat objekt DnsZone jako parametr Zone nebo můžete případně zadat zónu podle názvu. Pomocí parametru Confirm a $ConfirmPreference proměnné Windows PowerShellu můžete určit, jestli vás rutina vyzve k potvrzení. Pokud již existuje odpovídající RecordSet (stejný název a typ záznamu), je nutné zadat parametr Overwrite , jinak rutina nevytvoří novou RecordSet .

Příklady

Příklad 1: Vytvoření sady záznamů typu 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

Tento příklad vytvoří sadu záznamů s názvem www v zóně myzone.com. Sada záznamů je typu A a má hodnotu TTL 1 hodinu (3600 sekund). Obsahuje jeden záznam DNS.

Příklad 2: Vytvoření sady záznamů typu 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

Tento příklad vytvoří sadu záznamů s názvem www v zóně myzone.com. Sada záznamů je typu AAAA a má hodnotu TTL 1 hodinu (3600 sekund). Obsahuje jeden záznam DNS. Pokud chcete vytvořit sadu záznamů pouze pomocí jednoho řádku pn_PowerShell_short nebo vytvořit sadu záznamů s více záznamy, podívejte se na příklad 1.

Příklad 3: Vytvoření sady záznamů typu 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

Tento příklad vytvoří sadu záznamů s názvem www v zóně myzone.com. Sada záznamů je typu CNAME a má hodnotu TTL 1 hodinu (3600 sekund). Obsahuje jeden záznam DNS. Pokud chcete vytvořit sadu záznamů pouze pomocí jednoho řádku pn_PowerShell_short nebo vytvořit sadu záznamů s více záznamy, podívejte se na příklad 1.

Příklad 4: Vytvoření sady záznamů typu 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

Tento příkaz vytvoří sadu záznamů s názvem www v myzone.com zóny. Sada záznamů je typu MX a má hodnotu TTL 1 hodinu (3600 sekund). Obsahuje jeden záznam DNS. Pokud chcete vytvořit sadu záznamů pouze pomocí jednoho řádku pn_PowerShell_short nebo vytvořit sadu záznamů s více záznamy, podívejte se na příklad 1.

Příklad 5: Vytvoření sady záznamů typu 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

Tento příkaz vytvoří sadu záznamů s názvem ns1 v myzone.com zóny. Sada záznamů je typu NS a má hodnotu TTL 1 hodinu (3600 sekund). Obsahuje jeden záznam DNS. Pokud chcete vytvořit sadu záznamů pouze pomocí jednoho řádku pn_PowerShell_short nebo vytvořit sadu záznamů s více záznamy, podívejte se na příklad 1.

Příklad 6: Vytvoření sady záznamů typu 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

Tento příkaz vytvoří sadu záznamů s názvem 4 v zóně 3.2.1.in-addr.arpa. Sada záznamů je typu PTR a má hodnotu TTL 1 hodinu (3600 sekund). Obsahuje jeden záznam DNS. Pokud chcete vytvořit sadu záznamů pouze pomocí jednoho řádku pn_PowerShell_short nebo vytvořit sadu záznamů s více záznamy, podívejte se na příklad 1.

Příklad 7: Vytvoření sady záznamů typu 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

Tento příkaz vytvoří sadu záznamů s názvem _sip._tcp v myzone.com zóny. Sada záznamů je typu SRV a má hodnotu TTL 1 hodinu (3600 sekund). Obsahuje jeden záznam DNS odkazující na IP adresu 2001.2.3.4. Služba (sip) a protokol (tcp) jsou určeny jako součást názvu sady záznamů, nikoli jako součást dat záznamu. Pokud chcete vytvořit sadu záznamů pouze pomocí jednoho řádku pn_PowerShell_short nebo vytvořit sadu záznamů s více záznamy, podívejte se na příklad 1.

Příklad 8: Vytvoření sady záznamů typu 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

Tento příkaz vytvoří v myzone.com zóny pojmenovaný text Sady záznamů. Sada záznamů je typu TXT a má hodnotu TTL 1 hodinu (3600 sekund). Obsahuje jeden záznam DNS. Pokud chcete vytvořit sadu záznamů pouze pomocí jednoho řádku pn_PowerShell_short nebo vytvořit sadu záznamů s více záznamy, podívejte se na příklad 1.

Příklad 9: Vytvoření sady záznamů na vrcholu zóny

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

Tento příkaz vytvoří sadu záznamů na vrcholu (nebo kořenu) myzone.com zóny. Chcete-li to provést, název sady záznamů je určen jako @(včetně dvojitých uvozovek). Záznamy CNAME nelze vytvořit na vrcholu zóny. Jedná se o omezení standardů DNS; nejedná se o omezení Azure DNS. Pokud chcete vytvořit sadu záznamů pouze pomocí jednoho řádku pn_PowerShell_short nebo vytvořit sadu záznamů s více záznamy, podívejte se na příklad 1.

Příklad 10: Vytvoření sady záznamů se zástupným znakem

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

Tento příkaz vytvoří sadu záznamů s názvem * v myzone.com zóny. Toto je sada záznamů se zástupnými znaménámi. Pokud chcete vytvořit sadu záznamů pouze pomocí jednoho řádku pn_PowerShell_short nebo vytvořit sadu záznamů s více záznamy, podívejte se na příklad 1.

Příklad 11: Vytvoření prázdné sady záznamů

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

Tento příkaz vytvoří sadu záznamů s názvem www v myzone.com zóny. Sada záznamů je typu A a má hodnotu TTL 1 hodinu (3600 sekund). Jedná se o prázdnou sadu záznamů, která funguje jako zástupný symbol, do kterého můžete později přidat záznamy.

Příklad 12: Vytvoření sady záznamů a potlačení všech potvrzení

$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

Tento příkaz vytvoří sadu záznamů. Parametr Overwrite zajišťuje, že tato sada záznamů přepíše všechny existující sady záznamů se stejným názvem a typem (existující záznamy v této sadě záznamů budou ztraceny). Parametr Confirm s hodnotou $False potlačuje potvrzovací výzvu.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DnsRecords

Určuje pole záznamů DNS, které se mají zahrnout do sady záznamů. K vytvoření objektů záznamů DNS můžete použít rutinu New-AzDnsRecordConfig. Další informace najdete v příkladech.

Typ:DnsRecordBase[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Metadata

Určuje pole metadat, která se mají přidružit k sadě záznamů. Metadata se zadají pomocí párů name-value, které jsou reprezentované jako tabulky hash, například @{"dept"="shopping";" env"="production"}.

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje název sady záznamů , která se má vytvořit.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Overwrite

Označuje, že tato rutina přepíše zadanou sadu záznamů , pokud již existuje.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RecordType

Určuje typ záznamu DNS, který se má vytvořit. Platné hodnoty jsou:

  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • PTR
  • SRV
  • Záznamy TXT SOA se vytvoří automaticky při vytváření zóny a nelze je vytvořit ručně.
Typ:RecordType
Přípustné hodnoty:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ResourceGroupName

Určuje skupinu prostředků, která obsahuje zónu DNS. Chcete-li zadat název zóny, musíte také zadat parametr ZoneName . Alternativně můžete určit zónu a skupinu prostředků předáním objektu zóny DNS pomocí parametru Zone .

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-TargetResourceId

ID cílového prostředku aliasu

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Ttl

Určuje hodnotu TTL (Time to Live) pro sadu záznamů DNS.

Typ:UInt32
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Zone

Určuje DnsZone, ve kterém se má vytvořit Sada záznamů. Případně můžete zónu zadat pomocí parametrů ZoneName a ResourceGroupName .

Typ:DnsZone
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-ZoneName

Určuje název zóny, ve které se má vytvořit Sada záznamů. Musíte také zadat skupinu prostředků obsahující zónu pomocí parametru ResourceGroupName . Alternativně můžete určit zónu a skupinu prostředků předáním objektu zóny DNS pomocí parametru Zone .

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

String

DnsZone

UInt32

RecordType

Hashtable

DnsRecordBase[]

Výstupy

DnsRecordSet

Poznámky

Pomocí parametru Confirm můžete určit, jestli vás tato rutina vyzve k potvrzení. Ve výchozím nastavení vás rutina vyzve k potvrzení, pokud má proměnná $ConfirmPreference Prostředí Windows PowerShell hodnotu Střední nebo nižší. Pokud zadáte Potvrdit nebo Potvrdit:$True, zobrazí se tato rutina před spuštěním výzvy k potvrzení. Pokud zadáte Confirm :$False, rutina vás k potvrzení nezobrazí.