Sdílet prostřednictvím

New-AzDnsZone

  • Reference
Modul:
Az.Dns

Vytvoří novou zónu DNS.

Syntaxe

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

Rutina New-AzDnsZone vytvoří novou zónu DNS (Domain Name System) v zadané skupině prostředků. Pro parametr Name musíte zadat jedinečný název zóny DNS nebo rutina vrátí chybu. Po vytvoření zóny použijte rutinu New-AzDnsRecordSet k vytvoření sad záznamů v zóně. Pomocí parametru Confirm a $ConfirmPreference proměnné Windows PowerShellu můžete určit, jestli vás rutina vyzve k potvrzení.

Příklady

Příklad 1: Vytvoření zóny DNS

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

Tento příkaz vytvoří novou zónu DNS s názvem myzone.com v zadané skupině prostředků a uloží ji do proměnné $Zone.

Příklad 2: Vytvoření zóny Privátní DNS zadáním ID virtuální sítě

$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)

Tento příkaz vytvoří novou zónu Privátní DNS s názvem myprivatezone.com v zadané skupině prostředků s přidruženou virtuální sítí pro překlad (zadáním jejího ID) a uloží ji do proměnné $Zone.

Příklad 3: Vytvoření zóny Privátní DNS zadáním objektů virtuální sítě

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

Tento příkaz vytvoří novou zónu Privátní DNS s názvem myprivatezone.com v zadané skupině prostředků s přidruženou virtuální sítí pro překlad (na kterou odkazuje proměnná $ResVirtualNetwork) a uloží ji do proměnné $Zone.

Příklad 4: Vytvoření zóny DNS s delegováním zadáním názvu nadřazené zóny

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

Tento příkaz vytvoří novou podřízenou zónu DNS s názvem mychild.zone.com v zadané skupině prostředků a uloží ji do proměnné $Zone. Přidá také delegování do nadřazené zóny DNS s názvem zone.com umístěné ve stejném předplatném a skupině prostředků jako podřízená zóna.

Příklad 5: Vytvoření zóny DNS s delegováním zadáním ID nadřazené zóny

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

Tento příkaz vytvoří novou podřízenou zónu DNS s názvem mychild.zone.com v zadané skupině prostředků a uloží ji do proměnné $Zone. Přidá také delegování do nadřazené zóny DNS s názvem zone.com ve skupině prostředků, která poskytuje jiné předplatné, je stejné jako vytvořené podřízené zóny.

Příklad 6: Vytvoření zóny DNS s delegováním zadáním objektu nadřazené zóny

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

Tento příkaz vytvoří novou podřízenou zónu DNS s názvem mychild.zone.com v zadané skupině prostředků a uloží ji do proměnné $Zone. Přidá také delegování do nadřazené zóny DNS s názvem zone.com, jak je předáno v objektu ParentZone.

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

-Name

Určuje název zóny DNS, 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

-ParentZone

Úplný název nadřazené zóny pro přidání delegování (bez ukončující tečky)

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

-ParentZoneId

ID prostředku nadřazené zóny pro přidání delegování (bez koncové tečky)

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

-ParentZoneName

Úplný název nadřazené zóny pro přidání delegování (bez ukončující tečky)

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

-RegistrationVirtualNetwork

Seznam virtuálních sítí, které budou registrovat záznamy názvů hostitelů virtuálních počítačů v této zóně DNS, jsou k dispozici pouze pro privátní zóny.

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

-RegistrationVirtualNetworkId

Seznam ID virtuálních sítí, které budou registrovat záznamy názvů hostitelů virtuálních počítačů v této zóně DNS, jsou k dispozici pouze pro privátní zóny.

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

-ResolutionVirtualNetwork

Seznam virtuálních sítí schopných přeložit záznamy v této zóně DNS, který je k dispozici pouze pro privátní zóny.

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

-ResolutionVirtualNetworkId

Seznam ID virtuálních sítí schopných přeložit záznamy v této zóně DNS, který je k dispozici pouze pro privátní zóny.

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

-ResourceGroupName

Určuje skupinu prostředků, ve které se má zóna 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

-Tag

Páry klíč-hodnota ve formě tabulky hash. Příklad: @{key0="value0"; key1=$null; key2="value2"}

Typ:Hashtable
Aliasy:Tags
Position:Named
Default value:None
Vyžadováno:False
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 se nespustí. Ukazuje, co se stane, když se rutina spustí. 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

-ZoneType

Typ zóny, veřejné nebo soukromé. Zóny bez typu nebo typu Veřejné jsou zpřístupněny ve veřejné rovině obsluhy DNS pro použití v hierarchii DNS. Zóny s typem Privátní jsou viditelné pouze ze sady přidružených virtuálních sítí (tato funkce je ve verzi Preview). Tuto vlastnost nelze pro zónu změnit.

Typ:Nullable<T>[ZoneType]
Přípustné hodnoty:Public, Private
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

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]]

Výstupy

DnsZone

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í.