Dela via


Set-AzPrivateDnsZone

Uppdaterar en privat DNS-zon från en resursgrupp.

Syntax

Set-AzPrivateDnsZone
   -ResourceGroupName <String>
   -Name <String>
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzPrivateDnsZone
   -ResourceId <String>
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzPrivateDnsZone
   -PrivateZone <PSPrivateDnsZone>
   [-Tag <Hashtable>]
   [-Overwrite]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Cmdleten Set-AzPrivateDnsZone uppdaterar permanent en privat DNS-zon (Domain Name System) från en angiven resursgrupp. Du kan skicka ett PrivateDnsZone--objekt med hjälp av parametern PrivateZone eller med hjälp av pipelineoperatorn, eller så kan du ange parametrarna Name och ResourceGroupName. Du kan använda parametern Confirm och $ConfirmPreference Windows PowerShell för att kontrollera om cmdleten ber dig om bekräftelse. När du anger zonen med hjälp av ett PrivateDnsZone- -objekt (som skickas via pipelinen eller zone parameter) uppdateras inte zonen om den har ändrats i Azure DNS sedan det lokala PrivateDnsZone--objektet hämtades (endast åtgärder direkt på DNS-zonens resursantal som ändringar, åtgärder på postuppsättningar i zonen inte). Detta ger skydd för samtidiga zonändringar. Detta kan ignoreras med hjälp av parametern Overwrite, som uppdaterar zonen oavsett samtidiga ändringar.

Exempel

Exempel 1: Uppdaterar en privat zon

Set-AzPrivateDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup" -Tag @{tag1="value1";tag2="value2"}

Name                          : myzone.com
ResourceId                    : "/subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/PrivateZones/myzone.com"
ResourceGroupName             : MyResourceGroup
Location					  : 
Etag                          : xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Tags                          : {tag1="value1";tag2="value2"}
NumberOfRecordSets            : 1
MaxNumberOfRecordSets         : 5000

Det här kommandot uppdaterar zonen med namnet myzone.com från resursgruppen med namnet MyResourceGroup med de angivna taggarna. Använd Get-AzPrivateDnsZone för att hämta den uppdaterade zonen.

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å den privata DNS-zon som den här cmdleten uppdaterar. Du måste också ange parametern ResourceGroupName. Du kan också ange den privata DNS-zonen med parametern Zone.

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

-Overwrite

När du anger zonen med hjälp av ett PrivateDnsZone- -objekt (skickas via pipelinen eller zone parameter) uppdateras inte zonen om den har ändrats i Azure DNS sedan det lokala DnsZone--objektet hämtades (endast åtgärder direkt på DNS-zonens resursantal som ändringar, åtgärder på postuppsättningar i zonen inte). Detta ger skydd för samtidiga zonändringar. Detta kan ignoreras med hjälp av parametern Overwrite, som uppdaterar zonen oavsett samtidiga ändringar.

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

-PrivateZone

Det zonobjekt som ska anges.

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

-ResourceGroupName

Anger namnet på resursgruppen som innehåller den zon som ska uppdateras. Du måste också ange parametern ZoneName. Du kan också ange den privata DNS-zonen med hjälp av ett DnsZone--objekt som skickas via antingen pipelinen eller parametern Zone.

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

-ResourceId

Resurs-ID för privat DNS-zon.

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

-Tag

En hash-tabell som representerar resurstaggar.

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

-WhatIf

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

Indata

String

PSPrivateDnsZone

Utdata

PSPrivateDnsZone