New-AzDnsRecordSet

  • Odwołanie
Moduł:
Az.Dns

Tworzy zestaw rekordów DNS.

Składnia

New-AzDnsRecordSet
   -Name <String>
   -ZoneName <String>
   -ResourceGroupName <String>
   -Ttl <UInt32>
   -RecordType <RecordType>
   [-Metadata <Hashtable>]
   [-DnsRecords <DnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDnsRecordSet
   -Name <String>
   -ZoneName <String>
   -ResourceGroupName <String>
   [-Ttl <UInt32>]
   -RecordType <RecordType>
   -TargetResourceId <String>
   [-Metadata <Hashtable>]
   [-DnsRecords <DnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDnsRecordSet
   -Name <String>
   -Zone <DnsZone>
   -Ttl <UInt32>
   -RecordType <RecordType>
   [-Metadata <Hashtable>]
   [-DnsRecords <DnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzDnsRecordSet
   -Name <String>
   -Zone <DnsZone>
   [-Ttl <UInt32>]
   -RecordType <RecordType>
   -TargetResourceId <String>
   [-Metadata <Hashtable>]
   [-DnsRecords <DnsRecordBase[]>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Opis

Polecenie cmdlet New-AzDnsRecordSet tworzy nowy zestaw rekordów systemu nazw domen (DNS) o określonej nazwie i typie w określonej strefie. Obiekt RecordSet to zestaw rekordów DNS o tej samej nazwie i typie. Należy pamiętać, że nazwa jest względna względem strefy, a nie w pełni kwalifikowana nazwa. Parametr DnsRecords określa rekordy w zestawie rekordów. Ten parametr przyjmuje tablicę rekordów DNS skonstruowanych przy użyciu polecenia New-AzDnsRecordConfig. Możesz użyć operatora potoku, aby przekazać obiekt DnsZone do tego polecenia cmdlet, lub przekazać obiekt DnsZone jako parametr Strefy lub alternatywnie można określić strefę według nazwy. Możesz użyć parametru Confirm i $ConfirmPreference zmiennej programu Windows PowerShell, aby kontrolować, czy polecenie cmdlet wyświetli monit o potwierdzenie. Jeśli pasujący zestaw rekordów już istnieje (ta sama nazwa i typ rekordu ), musisz określić parametr Overwrite , w przeciwnym razie polecenie cmdlet nie utworzy nowego zestawu rekordów .

Przykłady

Przykład 1. Tworzenie zestawu rekordów typu A

$Records = @()
$Records += New-AzDnsRecordConfig -IPv4Address 1.2.3.4
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

# When creating a RecordSet containing a single record, the above sequence can also be condensed into a single line:

$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords (New-AzDnsRecordConfig -IPv4Address 1.2.3.4)

# To create a record set containing multiple records, use New-AzDnsRecordConfig to add each record to the $Records array,
# then call New-AzDnsRecordSet, as follows:

$Records = @()
$Records += New-AzDnsRecordConfig -IPv4Address 1.2.3.4
$Records += New-AzDnsRecordConfig -IPv4Address 5.6.7.8
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

W tym przykładzie tworzony jest zestaw rekordów o nazwie www w strefie myzone.com. Zestaw rekordów ma typ A i ma czas wygaśnięcia 1 godziny (3600 sekund). Zawiera pojedynczy rekord DNS.

Przykład 2. Tworzenie zestawu rekordów typu AAAA

$Records = @()
$Records += New-AzDnsRecordConfig -Ipv6Address 2001:db8::1
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType AAAA -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

W tym przykładzie tworzony jest zestaw rekordów o nazwie www w strefie myzone.com. Zestaw rekordów jest typu AAAA i ma czas wygaśnięcia 1 godziny (3600 sekund). Zawiera pojedynczy rekord DNS. Aby utworzyć zestaw rekordów przy użyciu tylko jednego wiersza pn_PowerShell_short lub utworzyć zestaw rekordów z wieloma rekordami, zobacz Przykład 1.

Przykład 3. Tworzenie zestawu rekordów typu CNAME

$Records = @()
$Records += New-AzDnsRecordConfig -Cname www.contoso.com
$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType CNAME -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

W tym przykładzie tworzony jest zestaw rekordów o nazwie www w strefie myzone.com. Zestaw rekordów jest typu CNAME i ma czas wygaśnięcia 1 godziny (3600 sekund). Zawiera pojedynczy rekord DNS. Aby utworzyć zestaw rekordów przy użyciu tylko jednego wiersza pn_PowerShell_short lub utworzyć zestaw rekordów z wieloma rekordami, zobacz Przykład 1.

Przykład 4. Tworzenie zestawu rekordów typu MX

$Records = @()
$Records += New-AzDnsRecordConfig -Exchange "mail.microsoft.com" -Preference 5
$RecordSet = New-AzDnsRecordSet -Name "mail" -RecordType MX -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

To polecenie tworzy zestaw rekordów o nazwie www w strefie myzone.com. Zestaw rekordów jest typu MX i ma czas wygaśnięcia 1 godziny (3600 sekund). Zawiera pojedynczy rekord DNS. Aby utworzyć zestaw rekordów przy użyciu tylko jednego wiersza pn_PowerShell_short lub utworzyć zestaw rekordów z wieloma rekordami, zobacz Przykład 1.

Przykład 5. Tworzenie zestawu rekordów typu NS

$Records = @()
$Records += New-AzDnsRecordConfig -Nsdname ns1-01.azure-dns.com
$RecordSet = New-AzDnsRecordSet -Name "ns1" -RecordType NS -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

To polecenie tworzy zestaw rekordów o nazwie ns1 w strefie myzone.com. Zestaw rekordów jest typu NS i ma czas wygaśnięcia 1 godziny (3600 sekund). Zawiera pojedynczy rekord DNS. Aby utworzyć zestaw rekordów przy użyciu tylko jednego wiersza pn_PowerShell_short lub utworzyć zestaw rekordów z wieloma rekordami, zobacz Przykład 1.

Przykład 6. Tworzenie zestawu rekordów typu PTR

$Records = @()
$Records += New-AzDnsRecordConfig -Ptrdname www.contoso.com
$RecordSet = New-AzDnsRecordSet -Name "4" -RecordType PTR -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "3.2.1.in-addr.arpa" -DnsRecords $Records

To polecenie tworzy zestaw rekordów o nazwie 4 w strefie 3.2.1.in-addr.arpa. Zestaw rekordów jest typu PTR i ma czas wygaśnięcia 1 godziny (3600 sekund). Zawiera pojedynczy rekord DNS. Aby utworzyć zestaw rekordów przy użyciu tylko jednego wiersza pn_PowerShell_short lub utworzyć zestaw rekordów z wieloma rekordami, zobacz Przykład 1.

Przykład 7. Tworzenie zestawu rekordów typu SRV

$Records = @()
$Records += New-AzDnsRecordConfig -Priority 0 -Weight 5 -Port 8080 -Target sipservice.contoso.com
$RecordSet = New-AzDnsRecordSet -Name "_sip._tcp" -RecordType SRV -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

To polecenie tworzy zestaw rekordów o nazwie _sip._tcp w strefie myzone.com. Zestaw rekordów jest typu SRV i ma czas wygaśnięcia 1 godziny (3600 sekund). Zawiera pojedynczy rekord DNS wskazujący adres IP 2001.2.3.4. Usługa (sip) i protokół (tcp) są określane jako część nazwy zestawu rekordów, a nie jako część danych rekordu. Aby utworzyć zestaw rekordów przy użyciu tylko jednego wiersza pn_PowerShell_short lub utworzyć zestaw rekordów z wieloma rekordami, zobacz Przykład 1.

Przykład 8. Tworzenie zestawu rekordów typu TXT

$Records = @()
$Records += New-AzDnsRecordConfig -Value "This is a TXT Record"
$RecordSet = New-AzDnsRecordSet -Name "text" -RecordType TXT -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

To polecenie tworzy element RecordSet o nazwie text w strefie myzone.com. Zestaw rekordów jest typu TXT i ma czas wygaśnięcia 1 godziny (3600 sekund). Zawiera pojedynczy rekord DNS. Aby utworzyć zestaw rekordów przy użyciu tylko jednego wiersza pn_PowerShell_short lub utworzyć zestaw rekordów z wieloma rekordami, zobacz Przykład 1.

Przykład 9. Tworzenie zestawu rekordów w wierzchołka strefy

$Records = @()
$Records += New-AzDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzDnsRecordSet -Name "@" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

To polecenie tworzy zestaw rekordów w wierzchołka (lub katalogu głównym) strefy myzone.com. W tym celu nazwa zestawu rekordów jest określona jako "@" (w tym podwójne cudzysłowy). Nie można utworzyć rekordów CNAME w wierzchołku strefy. Jest to ograniczenie standardów DNS; nie jest to ograniczenie usługi Azure DNS. Aby utworzyć zestaw rekordów przy użyciu tylko jednego wiersza pn_PowerShell_short lub utworzyć zestaw rekordów z wieloma rekordami, zobacz Przykład 1.

Przykład 10: Tworzenie zestawu rekordów wieloznacznych

$Records = @()
$Records += New-AzDnsRecordConfig -Ipv4Address 1.2.3.4
$RecordSet = New-AzDnsRecordSet -Name "*" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords $Records

To polecenie tworzy zestaw rekordów o nazwie * w strefie myzone.com. Jest to zestaw rekordów wieloznacznych. Aby utworzyć zestaw rekordów przy użyciu tylko jednego wiersza pn_PowerShell_short lub utworzyć zestaw rekordów z wieloma rekordami, zobacz Przykład 1.

Przykład 11. Tworzenie pustego zestawu rekordów

$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords @()

To polecenie tworzy zestaw rekordów o nazwie www w strefie myzone.com. Zestaw rekordów ma typ A i ma czas wygaśnięcia 1 godziny (3600 sekund). Jest to pusty zestaw rekordów, który działa jako symbol zastępczy, do którego można później dodawać rekordy.

Przykład 12: Tworzenie zestawu rekordów i pomijanie wszystkich potwierdzeń

$RecordSet = New-AzDnsRecordSet -Name "www" -RecordType A -ResourceGroupName "MyResourceGroup" -TTL 3600 -ZoneName "myzone.com" -DnsRecords (New-AzDnsRecordConfig -Ipv4Address 1.2.3.4) -Confirm:$False -Overwrite

To polecenie tworzy zestaw rekordów. Parametr Overwrite gwarantuje, że ten zestaw rekordów zastępuje każdy wstępnie istniejący zestaw rekordów o tej samej nazwie i typie (istniejące rekordy w tym zestawie rekordów zostaną utracone). Parametr Confirm z wartością $False pomija monit o potwierdzenie.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DnsRecords

Określa tablicę rekordów DNS do uwzględnienia w zestawie rekordów. Aby utworzyć obiekty rekordów DNS, można użyć polecenia cmdlet New-AzDnsRecordConfig. Zobacz przykłady, aby uzyskać więcej informacji.

Type:DnsRecordBase[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Metadata

Określa tablicę metadanych do skojarzenia z zestawem rekordów. Metadane są określane przy użyciu par name-value, które są reprezentowane jako tabele skrótów, na przykład @{"dept"="shopping";" env"="production"}.

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Określa nazwę zestawu rekordów do utworzenia.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Overwrite

Wskazuje, że to polecenie cmdlet zastępuje określony zestaw rekordów , jeśli już istnieje.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RecordType

Określa typ rekordu DNS do utworzenia. Prawidłowe wartości to:

  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • PTR
  • SRV
  • Rekordy SOA TXT są tworzone automatycznie po utworzeniu strefy i nie można ich utworzyć ręcznie.
Type:RecordType
Accepted values:A, Aaaa, CAA, Cname, MX, NS, PTR, SOA, SRV, TXT, Tlsa, DS, Naptr
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Określa grupę zasobów zawierającą strefę DNS. Należy również określić parametr ZoneName, aby określić nazwę strefy. Alternatywnie można określić strefę i grupę zasobów, przekazując obiekt strefy DNS przy użyciu parametru Zone .

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TargetResourceId

Identyfikator zasobu docelowego aliasu.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Ttl

Określa czas wygaśnięcia (TTL) dla zestawu rekordów DNS.

Type:UInt32
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

Określa strefę DnsZone, w której ma zostać utworzony zestaw rekordów. Alternatywnie można określić strefę przy użyciu parametrów ZoneName i ResourceGroupName .

Type:DnsZone
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ZoneName

Określa nazwę strefy, w której ma zostać utworzony zestaw rekordów. Należy również określić grupę zasobów zawierającą strefę przy użyciu parametru ResourceGroupName . Alternatywnie można określić strefę i grupę zasobów, przekazując obiekt strefy DNS przy użyciu parametru Zone .

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Dane wejściowe

String

DnsZone

UInt32

RecordType

Hashtable

DnsRecordBase[]

Dane wyjściowe

DnsRecordSet

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.