New-AzDnsZone

  • Referenz
Modul:
Az.Dns

Erstellt eine neue DNS-Zone.

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

Beschreibung

Das Cmdlet New-AzDnsZone erstellt eine neue DNS-Zone (Domain Name System) in der angegebenen Ressourcengruppe. Sie müssen einen eindeutigen DNS-Zonennamen für den Parameter Name angeben, oder das Cmdlet gibt einen Fehler zurück. Nachdem die Zone erstellt wurde, verwenden Sie das Cmdlet New-AzDnsRecordSet, um Datensatzsätze in der Zone zu erstellen. Sie können den Parameter "Confirm" und $ConfirmPreference Windows PowerShell-Variable verwenden, um zu steuern, ob das Cmdlet Sie zur Bestätigung auffordert.

Beispiele

Beispiel 1: Erstellen einer DNS-Zone

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

Mit diesem Befehl wird eine neue DNS-Zone namens myzone.com in der angegebenen Ressourcengruppe erstellt und dann in der variablen $Zone gespeichert.

Beispiel 2: Erstellen einer Privates DNS Zone durch Angeben von virtuellen Netzwerk-IDs

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

Dieser Befehl erstellt eine neue Privates DNS Zone namens myprivatezone.com in der angegebenen Ressourcengruppe mit einem zugeordneten virtuellen Auflösungsnetzwerk (angeben der ID), und speichert sie dann in der $Zone Variablen.

Beispiel 3: Erstellen einer Privates DNS Zone durch Angeben von virtuellen Netzwerkobjekten

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

Mit diesem Befehl wird eine neue Privates DNS Zone namens myprivatezone.com in der angegebenen Ressourcengruppe mit einem zugeordneten virtuellen Auflösungsnetzwerk erstellt (auf $ResVirtualNetwork Variable verwiesen), und speichert sie dann in der variablen $Zone.

Beispiel 4: Erstellen einer DNS-Zone mit Delegierung durch Angeben des Namens der übergeordneten Zone

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

Mit diesem Befehl wird eine neue untergeordnete DNS-Zone namens mychild.zone.com in der angegebenen Ressourcengruppe erstellt und in der variablen $Zone gespeichert. Außerdem wird delegierung in der übergeordneten DNS-Zone namens zone.com in derselben Abonnement- und Ressourcengruppe wie die untergeordnete Zone hinzugefügt.

Beispiel 5: Erstellen einer DNS-Zone mit Delegierung durch Angeben der id der übergeordneten Zone

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

Mit diesem Befehl wird eine neue untergeordnete DNS-Zone namens mychild.zone.com in der angegebenen Ressourcengruppe erstellt und in der variablen $Zone gespeichert. Außerdem wird delegierung in der übergeordneten DNS-Zone mit dem Namen zone.com in der Ressourcengruppe", die andere vom rg bereitgestellte Abonnement angegeben ist, mit der der von der erstellten untergeordneten Zone identisch ist.

Beispiel 6: Erstellen einer DNS-Zone mit Delegierung durch Angeben des übergeordneten Zonenobjekts

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

Mit diesem Befehl wird eine neue untergeordnete DNS-Zone namens mychild.zone.com in der angegebenen Ressourcengruppe erstellt und in der variablen $Zone gespeichert. Außerdem wird delegierung in der übergeordneten DNS-Zone namens zone.com hinzugefügt, die im ParentZone-Objekt übergeben wird.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen der zu erstellenden DNS-Zone an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ParentZone

Der vollständige Name der übergeordneten Zone, die Delegierung hinzugefügt werden soll (ohne einen punktierenden Punkt).

Typ:DnsZone
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ParentZoneId

Die Ressourcen-ID der übergeordneten Zone, die Delegierung hinzugefügt werden soll (ohne einen punktierenden Punkt).

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ParentZoneName

Der vollständige Name der übergeordneten Zone, die Delegierung hinzugefügt werden soll (ohne einen punktierenden Punkt).

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-RegistrationVirtualNetwork

Die Liste der virtuellen Netzwerke, die Hostnameneinträge virtueller Computer in dieser DNS-Zone registrieren, nur für private Zonen verfügbar.

Typ:List<T>[IResourceReference]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-RegistrationVirtualNetworkId

Die Liste der virtuellen Netzwerk-IDs, die Hostnamen für virtuelle Computer in dieser DNS-Zone registrieren, nur für private Zonen verfügbar.

Typ:List<T>[String]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResolutionVirtualNetwork

Die Liste der virtuellen Netzwerke, die Einträge in dieser DNS-Zone auflösen können, nur für private Zonen verfügbar.

Typ:List<T>[IResourceReference]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResolutionVirtualNetworkId

Die Liste der virtuellen Netzwerk-IDs, die Datensätze in dieser DNS-Zone auflösen können, nur für private Zonen verfügbar.

Typ:List<T>[String]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Gibt die Ressourcengruppe an, in der die Zone erstellt werden soll.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Tag

Schlüssel-Wert-Paare in Form einer Hashtabelle. Beispiel: @{key0="value0"; key1=$null; key2="value2"}

Typ:Hashtable
Aliase:Tags
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt. Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ZoneType

Der Typ der Zone, öffentlich oder privat. Zonen ohne Typ oder mit einem Öffentlichen Typ werden auf der öffentlichen DNS-Dienstebene zur Verwendung in der DNS-Hierarchie zur Verfügung gestellt. Zonen mit einem Typ "Privat" werden nur von der Gruppe der zugeordneten virtuellen Netzwerke angezeigt (dieses Feature befindet sich in der Vorschau). Diese Eigenschaft kann für eine Zone nicht geändert werden.

Typ:Nullable<T>[ZoneType]
Zulässige Werte:Public, Private
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

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

Ausgaben

DnsZone

Hinweise

Mit dem Parameter "Confirm" können Sie steuern, ob dieses Cmdlet Sie zur Bestätigung auffordert. Standardmäßig werden Sie vom Cmdlet zur Bestätigung aufgefordert, wenn die $ConfirmPreference Windows PowerShell-Variable den Wert "Mittel" oder "niedriger" aufweist. Wenn Sie "Confirm" oder "Confirm:$True" angeben, werden Sie mit diesem Cmdlet vor der Ausführung zur Bestätigung aufgefordert. Wenn Sie "Confirm:$False" angeben, werden Sie vom Cmdlet nicht zur Bestätigung aufgefordert.