Udostępnij za pośrednictwem

New-AzDnsZone

  • Odwołanie
Moduł:
Az.Dns

Tworzy nową strefę DNS.

Składnia

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

Opis

Polecenie cmdlet New-AzDnsZone tworzy nową strefę systemu nazw domen (DNS) w określonej grupie zasobów. Musisz określić unikatową nazwę strefy DNS dla parametru Nazwa lub polecenie cmdlet zwróci błąd. Po utworzeniu strefy użyj polecenia cmdlet New-AzDnsRecordSet, aby utworzyć zestawy rekordów w strefie. Możesz użyć parametru Confirm i $ConfirmPreference zmiennej programu Windows PowerShell, aby kontrolować, czy polecenie cmdlet wyświetli monit o potwierdzenie.

Przykłady

Przykład 1. Tworzenie strefy DNS

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

To polecenie tworzy nową strefę DNS o nazwie myzone.com w określonej grupie zasobów, a następnie zapisuje ją w zmiennej $Zone.

Przykład 2. Tworzenie strefy Prywatna strefa DNS przez określenie identyfikatorów sieci wirtualnej

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

To polecenie tworzy nową strefę Prywatna strefa DNS o nazwie myprivatezone.com w określonej grupie zasobów ze skojarzą siecią wirtualną rozpoznawania (określając jej identyfikator), a następnie zapisuje ją w zmiennej $Zone.

Przykład 3. Tworzenie strefy Prywatna strefa DNS przez określenie obiektów sieci wirtualnej

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

To polecenie tworzy nową strefę Prywatna strefa DNS o nazwie myprivatezone.com w określonej grupie zasobów ze skojarzą siecią wirtualną rozpoznawania (o której mowa w zmiennej $ResVirtualNetwork), a następnie przechowuje ją w zmiennej $Zone.

Przykład 4. Tworzenie strefy DNS z delegowaniem przez określenie nazwy strefy nadrzędnej

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

To polecenie tworzy nową podrzędną strefę DNS o nazwie mychild.zone.com w określonej grupie zasobów i przechowuje w zmiennej $Zone. Dodaje również delegowanie w nadrzędnej strefie DNS o nazwie zone.com znajdującej się w tej samej subskrypcji i grupie zasobów co strefa podrzędna.

Przykład 5. Tworzenie strefy DNS z delegowaniem przez określenie identyfikatora strefy nadrzędnej

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

To polecenie tworzy nową podrzędną strefę DNS o nazwie mychild.zone.com w określonej grupie zasobów i przechowuje w zmiennej $Zone. Dodaje również delegowanie w nadrzędnej strefie DNS o nazwie zone.com w grupie zasobów innej subskrypcji udostępnionej przez grupę zasobów jest taka sama jak utworzona strefa podrzędna.

Przykład 6. Tworzenie strefy DNS z delegowaniem przez określenie obiektu strefy nadrzędnej

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

To polecenie tworzy nową podrzędną strefę DNS o nazwie mychild.zone.com w określonej grupie zasobów i przechowuje w zmiennej $Zone. Dodaje również delegowanie w nadrzędnej strefie DNS o nazwie zone.com jako przekazane w obiekcie ParentZone

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure

Typ:IAzureContextContainer
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę strefy DNS do utworzenia.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ParentZone

Pełna nazwa strefy nadrzędnej do dodania delegowania (bez kropki zakończenia).

Typ:DnsZone
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ParentZoneId

Identyfikator zasobu strefy nadrzędnej do dodania delegowania (bez kropki zakończenia).

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ParentZoneName

Pełna nazwa strefy nadrzędnej do dodania delegowania (bez kropki zakończenia).

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-RegistrationVirtualNetwork

Lista sieci wirtualnych, które będą rejestrować rekordy hostów maszyn wirtualnych w tej strefie DNS, dostępne tylko dla stref prywatnych.

Typ:List<T>[IResourceReference]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-RegistrationVirtualNetworkId

Lista identyfikatorów sieci wirtualnej, które będą rejestrować rekordy nazw hostów maszyn wirtualnych w tej strefie DNS, dostępne tylko dla stref prywatnych.

Typ:List<T>[String]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ResolutionVirtualNetwork

Lista sieci wirtualnych, które mogą rozpoznawać rekordy w tej strefie DNS, dostępne tylko dla stref prywatnych.

Typ:List<T>[IResourceReference]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ResolutionVirtualNetworkId

Lista identyfikatorów sieci wirtualnej, które mogą rozpoznawać rekordy w tej strefie DNS, dostępne tylko dla stref prywatnych.

Typ:List<T>[String]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ResourceGroupName

Określa grupę zasobów, w której ma zostać utworzona strefa.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Tag

Pary klucz-wartość w postaci tabeli skrótów. Na przykład: @{key0="value0"; key1=$null; key2="value2"}

Typ:Hashtable
Aliasy:Tags
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane. Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ZoneType

Typ strefy, publiczny lub prywatny. Strefy bez typu lub typu Publiczne są udostępniane na publicznej płaszczyźnie obsługującej system DNS do użycia w hierarchii DNS. Strefy o typie Prywatny są widoczne tylko z zestawu skojarzonych sieci wirtualnych (ta funkcja jest dostępna w wersji zapoznawczej). Tej właściwości nie można zmienić dla strefy.

Typ:Nullable<T>[ZoneType]
Dopuszczalne wartości:Public, Private
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

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

Dane wyjściowe

DnsZone

Uwagi

Możesz użyć parametru Confirm, aby określić, czy to polecenie cmdlet wyświetli monit o potwierdzenie. Domyślnie polecenie cmdlet wyświetla monit o potwierdzenie, jeśli zmienna programu Windows PowerShell $ConfirmPreference ma wartość Średnia lub niższa. Jeśli określisz opcję Potwierdź lub Potwierdź:$True, to polecenie cmdlet wyświetli monit o potwierdzenie przed jego uruchomieniem. Jeśli określisz wartość Confirm:$False, polecenie cmdlet nie wyświetli monitu o potwierdzenie.