New-AzPrivateDnsRecordSet
Vytvoří sadu záznamů v zóně privátního DNS.
Syntaxe
New-AzPrivateDnsRecordSet
-ResourceGroupName <String>
-ZoneName <String>
-Name <String>
-RecordType <RecordType>
-Ttl <UInt32>
[-Metadata <Hashtable>]
[-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzPrivateDnsRecordSet
-Zone <PSPrivateDnsZone>
-Name <String>
-RecordType <RecordType>
-Ttl <UInt32>
[-Metadata <Hashtable>]
[-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzPrivateDnsRecordSet
-ParentResourceId <String>
-Name <String>
-RecordType <RecordType>
-Ttl <UInt32>
[-Metadata <Hashtable>]
[-PrivateDnsRecord <PSPrivateDnsRecordBase[]>]
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Rutina New-AzPrivateDnsRecordSet vytvoří novou sadu záznamů DNS (Private Domain Name System) se zadaným názvem a typem v zadané privátní zóně. Objekt RecordSet je sada privátních záznamů DNS se stejným názvem a typem. Všimněte si, že název je relativní vzhledem k privátní zóně a nikoli plně kvalifikovaný název. Parametr PrivateDnsRecord určuje záznamy v sadě záznamů. Tento parametr přebírá pole privátních záznamů DNS vytvořených pomocí New-AzPrivateDnsRecordConfig. Operátor kanálu můžete použít k předání objektu PSPrivateDnsZone této rutině nebo můžete předat objekt PSPrivateDnsZone jako parametr Zone, nebo můžete zónu zadat podle jeho ResourceId nebo případně můžete zadat zónu podle názvu. Pomocí parametru Confirm a $ConfirmPreference proměnné Prostředí Windows PowerShell 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-AzPrivateDnsRecordConfig -IPv4Address 1.2.3.4
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
# When creating a RecordSet containing a single record, the above sequence can also be condensed into a single line:
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords (New-AzPrivateDnsRecordConfig -IPv4Address 1.2.3.4)
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.Netwo
rk/privateDnsZones/myzone.com/A/www
Name : www
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : A
Records : {1.2.3.4}
Metadata :
IsAutoRegistered :
# To create a record set containing multiple records, use New-AzPrivateDnsRecordConfig to add each record to the $Records array,
# then call New-AzPrivateDnsRecordSet, as follows:
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -IPv4Address 1.2.3.4
$Records += New-AzPrivateDnsRecordConfig -IPv4Address 5.6.7.8
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.Netwo
rk/privateDnsZones/myzone.com/A/www
Name : www
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : A
Records : {1.2.3.4, 5.6.7.8}
Metadata :
IsAutoRegistered :Tento příklad vytvoří sadu záznamů s názvem www v privátní zóně myzone.com. Sada záznamů je typu A a má hodnotu TTL 1 hodinu (3600 sekund). Obsahuje jeden privátní záznam DNS.
Příklad 2: Vytvoření sady záznamů typu AAAA
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ipv6Address 2001:db8::1
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/AAAA/www
Name : www
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : AAAA
Records : {2001:db8::1}
Metadata :
IsAutoRegistered :Tento příklad vytvoří sadu záznamů s názvem www v privátní zóně myzone.com. Sada záznamů je typu AAAA a má hodnotu TTL 1 hodinu (3600 sekund). Obsahuje jeden privátní 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-AzPrivateDnsRecordConfig -Cname www.contoso.com
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/CNAME/www
Name : www
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : CNAME
Records : {www.contoso.com}
Metadata :
IsAutoRegistered :Tento příklad vytvoří sadu záznamů s názvem www v privátní zóně myzone.com. Sada záznamů je typu CNAME a má hodnotu TTL 1 hodinu (3600 sekund). Obsahuje jeden privátní 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-AzPrivateDnsRecordConfig -Exchange "mail.microsoft.com" -Preference 5
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType MX -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/MX/www
Name : www
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : MX
Records : {[5,mail.microsoft.com]}
Metadata :
IsAutoRegistered :Tento příkaz vytvoří sadu záznamů s názvem www v privátní zóně myzone.com. Sada záznamů je typu MX a má hodnotu TTL 1 hodinu (3600 sekund). Obsahuje jeden privátní 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 PTR
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ptrdname www.contoso.com
$RecordSet = New-AzPrivateDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "3.2.1.in-addr.arpa" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/3.2.1.in-addr.arpa/PTR/4
Name : 4
ZoneName : 3.2.1.in-addr.arpa
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : PTR
Records : {www.contoso.com}
Metadata :
IsAutoRegistered :Tento příkaz vytvoří sadu záznamů s názvem 4 v privátní zóně 3.2.1.in-addr.arpa. Sada záznamů je typu PTR a má hodnotu TTL 1 hodinu (3600 sekund). Obsahuje jeden privátní 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 SRV
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target sipservice.contoso.com
$RecordSet = New-AzPrivateDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/SRV/_sip._tcp
Name : _sip._tcp
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : SRV
Records : {[0,5,8080,sipservice.contoso.com]}
Metadata :
IsAutoRegistered :Tento příkaz vytvoří sadu záznamů s názvem _sip._tcp v privátní zóně myzone.com. Sada záznamů je typu SRV a má hodnotu TTL 1 hodinu (3600 sekund). Obsahuje jeden privátní 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 7: Vytvoření sady záznamů typu TXT
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Value "This is a TXT Record"
$RecordSet = New-AzPrivateDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/TXT/text
Name : text
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : TXT
Records : {This is a TXT Record}
Metadata :
IsAutoRegistered :Tento příkaz vytvoří v myzone.com privátní zóny pojmenovaný text Sady záznamů. Sada záznamů je typu TXT a má hodnotu TTL 1 hodinu (3600 sekund). Obsahuje jeden privátní 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 8: Vytvoření sady záznamů na vrcholu zóny
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzPrivateDnsRecordSet -Name "@" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/A/@
Name : @
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : A
Records : {1.2.3.4}
Metadata :
IsAutoRegistered :Tento příkaz vytvoří sadu záznamů na vrcholu (nebo kořenovém adresáři) privátní zóny myzone.com. 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í privátního DNS Azure. 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ů se zástupným znakem
$Records = @()
$Records += New-AzPrivateDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzPrivateDnsRecordSet -Name "*" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords $Records
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/A/@
Name : *
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : A
Records : {1.2.3.4}
Metadata :
IsAutoRegistered :Tento příkaz vytvoří sadu záznamů s názvem * v privátní zóně myzone.com. 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 10: Vytvoření prázdné sady záznamů
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords @()
Id : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myresourcegroup/providers/Micros
oft.Network/privateDnsZones/myzone.com/A/@
Name : *
ZoneName : myzone.com
ResourceGroupName : MyResourceGroup
Ttl : 3600
Etag : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
RecordType : A
Records : {}
Metadata :
IsAutoRegistered :Tento příkaz vytvoří sadu záznamů s názvem * v privátní zóně myzone.com. 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 11: Vytvoření sady záznamů a potlačení všech potvrzení
$RecordSet = New-AzPrivateDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -PrivateDnsRecords (New-AzDnsRecordConfig -Ipv4Address 1.2.3.4) -Confirm:$False -OverwriteTento 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 vás vyzve k potvrzení.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Default value: | None |
| 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 |
-Metadata
Tabulka hash, která představuje značky prostředků.
| Typ: | Hashtable |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Name
Název záznamů v této sadě záznamů (vzhledem k názvu zóny a bez koncové tečky).
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Overwrite
Pokud sada záznamů již existuje, nepovede selhat.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ParentResourceId
ID prostředku privátní zóny DNS.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-PrivateDnsRecord
Privátní záznamy DNS, které jsou součástí této sady záznamů.
| Typ: | PSPrivateDnsRecordBase[] |
| Aliasy: | PrivateDnsRecords |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-RecordType
Typ privátních záznamů DNS v této sadě záznamů.
| Typ: | RecordType |
| Přípustné hodnoty: | A, AAAA, CNAME, MX, PTR, SOA, SRV, TXT |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ResourceGroupName
Skupina prostředků, do které zóna patří.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Ttl
Hodnota TTL všech záznamů v této sadě záznamů.
| Typ: | UInt32 |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-WhatIf
Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Zone
PrivateDnsZone objekt představující zónu, ve které chcete vytvořit sadu záznamů.
| Typ: | PSPrivateDnsZone |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-ZoneName
Zóna, ve které chcete vytvořit sadu záznamů (bez ukončující tečky).
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
Vstupy
Výstupy
Azure PowerShell