Dela via


New-AzDnsZone

Skapar en ny DNS-zon.

Syntax

New-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-ZoneType <ZoneType>]
   [-ParentZoneId <String>]
   [-Tag <Hashtable>]
   [-RegistrationVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
   [-ResolutionVirtualNetworkId <System.Collections.Generic.List`1[System.String]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-ZoneType <ZoneType>]
   [-ParentZoneName <String>]
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDnsZone
   -Name <String>
   -ResourceGroupName <String>
   [-ZoneType <ZoneType>]
   [-ParentZone <DnsZone>]
   [-Tag <Hashtable>]
   [-RegistrationVirtualNetwork <System.Collections.Generic.List`1[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference]>]
   [-ResolutionVirtualNetwork <System.Collections.Generic.List`1[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cmdleten New-AzDnsZone skapar en ny DNS-zon (Domain Name System) i den angivna resursgruppen. Du måste ange ett unikt DNS-zonnamn för parametern Namn , annars returnerar cmdleten ett fel. När zonen har skapats använder du cmdleten New-AzDnsRecordSet för att skapa postuppsättningar i zonen. Du kan använda parametern Confirm och $ConfirmPreference Windows PowerShell för att kontrollera om cmdleten ber dig om bekräftelse.

Exempel

Exempel 1: Skapa en DNS-zon

$Zone = New-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"

Det här kommandot skapar en ny DNS-zon med namnet myzone.com i den angivna resursgruppen och lagrar den sedan i variabeln $Zone.

Exempel 2: Skapa en privat DNS-zon genom att ange virtuella nätverks-ID:n

$ResVirtualNetworkId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testresgroup/providers/Microsoft.Network/virtualNetworks/resvnet"
$Zone = New-AzDnsZone -Name "myprivatezone.com" -ResourceGroupName "MyResourceGroup" -ZoneType Private -ResolutionVirtualNetworkId @($ResVirtualNetworkId)

Det här kommandot skapar en ny privat DNS-zon med namnet myprivatezone.com i den angivna resursgruppen med ett associerat virtuellt matchningsnätverk (anger dess ID) och lagrar den sedan i variabeln $Zone.

Exempel 3: Skapa en privat DNS-zon genom att ange virtuella nätverksobjekt

$ResVirtualNetwork = Get-AzVirtualNetwork -Name "resvnet" -ResourceGroupName "testresgroup"
$Zone = New-AzDnsZone -Name "myprivatezone.com" -ResourceGroupName "MyResourceGroup" -ZoneType Private -ResolutionVirtualNetwork @($ResVirtualNetwork)

Det här kommandot skapar en ny privat DNS-zon med namnet myprivatezone.com i den angivna resursgruppen med ett associerat virtuellt nätverk för matchning (som anges av $ResVirtualNetwork variabel) och lagrar den sedan i variabeln $Zone.

Exempel 4: Skapa en DNS-zon med delegering genom att ange det överordnade zonnamnet

$Zone = New-AzDnsZone -Name "mychild.zone.com" -ResourceGroupName "MyResourceGroup" -ParentZoneName "zone.com"

Det här kommandot skapar en ny underordnad DNS-zon med namnet mychild.zone.com i den angivna resursgruppen och lagrar i variabeln $Zone. Den lägger också till delegering i den överordnade DNS-zonen med namnet zone.com som finns i samma prenumeration och resursgrupp som den underordnade zonen.

Exempel 5: Skapa en DNS-zon med delegering genom att ange överordnat zon-ID

$Zone = New-AzDnsZone -Name "mychild.zone.com" -ResourceGroupName "MyResourceGroup" -ParentZoneId "/subscriptions/**67e2/resourceGroups/other-rg/providers/Microsoft.Network/dnszones/zone.com"

Det här kommandot skapar en ny underordnad DNS-zon med namnet mychild.zone.com i den angivna resursgruppen och lagrar i variabeln $Zone. Den lägger också till delegering i den överordnade DNS-zonen med namnet zone.com i den angivna prenumerationen för resursgruppen other-rg är samma som för den underordnade zon som skapats.

Exempel 6: Skapa en DNS-zon med delegering genom att ange det överordnade zonobjektet

$PZone = New-AzDnsZone -Name "zone.com" -ResourceGroupName "MyResourceGroup" 
$Zone = New-AzDnsZone -Name "mychild.zone.com" -ResourceGroupName "MyResourceGroup" -ParentZone @($PZone)

Det här kommandot skapar en ny underordnad DNS-zon med namnet mychild.zone.com i den angivna resursgruppen och lagrar i variabeln $Zone. Den lägger också till delegering i den överordnade DNS-zonen med namnet zone.com som skickas i ParentZone-objektet

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

-Name

Anger namnet på DNS-zonen som ska skapas.

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

-ParentZone

Det fullständiga namnet på den överordnade zonen för att lägga till delegering (utan en avslutande punkt).

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

-ParentZoneId

Resurs-ID för den överordnade zonen för att lägga till delegering (utan en avslutande punkt).

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

-ParentZoneName

Det fullständiga namnet på den överordnade zonen för att lägga till delegering (utan en avslutande punkt).

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

-RegistrationVirtualNetwork

Listan över virtuella nätverk som registrerar värdnamn för virtuella datorer i den här DNS-zonen, endast tillgänglig för privata zoner.

Typ:List<T>[IResourceReference]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-RegistrationVirtualNetworkId

Listan över virtuella nätverks-ID:n som registrerar värdnamn för virtuella datorer i den här DNS-zonen, endast tillgängliga för privata zoner.

Typ:List<T>[String]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResolutionVirtualNetwork

Listan över virtuella nätverk som kan matcha poster i den här DNS-zonen, endast tillgänglig för privata zoner.

Typ:List<T>[IResourceReference]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResolutionVirtualNetworkId

Listan över virtuella nätverks-ID:n som kan matcha poster i den här DNS-zonen, endast tillgängliga för privata zoner.

Typ:List<T>[String]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ResourceGroupName

Anger den resursgrupp där zonen ska skapas.

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

-Tag

Nyckel/värde-par i form av en hash-tabell. Exempel: @{key0="value0"; key1=$null; key2="value2"}

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

-WhatIf

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

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

-ZoneType

Typ av zon, offentlig eller privat. Zoner utan typ eller med en typ av offentlig görs tillgängliga på det offentliga DNS-serverplanet för användning i DNS-hierarkin. Zoner med en typ av privat visas endast från med den uppsättning associerade virtuella nätverk (den här funktionen är i förhandsversion). Det går inte att ändra den här egenskapen för en zon.

Typ:Nullable<T>[ZoneType]
Godkända värden:Public, Private
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Indata

String

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

Hashtable

List<T>[[System.String, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

List<T>[[Microsoft.Azure.Management.Internal.Network.Common.IResourceReference, Microsoft.Azure.PowerShell.Clients.Network, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

Utdata

DnsZone

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.