Set-AzDnsRecordSet
DNS レコード セットを更新します。
構文
Default (既定)
Set-AzDnsRecordSet
-RecordSet <DnsRecordSet>
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
Set-AzDnsRecordSet コマンドレットは、ローカル RecordSet オブジェクトからAzure DNS サービスのレコード セットを更新します。 パラメーターとして、またはパイプライン演算子を使用して 、RecordSet オブジェクトを渡すことができます。 Confirm パラメーターと$ConfirmPreference Windows PowerShell 変数を使用して、コマンドレットで確認を求めるメッセージを表示するかどうかを制御できます。 レコード セットは、ローカル RecordSet オブジェクトが取得されてからAzure DNSで変更された場合は更新されません。 これにより、同時変更の保護が提供されます。 この動作は、レコード セットを同時変更に関係なく更新する Overwrite パラメーターを使用して抑制できます。
例
例 1: レコード セットを更新する
$RecordSet = Get-AzDnsRecordSet -ResourceGroupName MyResourceGroup -ZoneName myzone.com -Name www -RecordType A
Add-AzDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 172.16.0.0
Add-AzDnsRecordConfig -RecordSet $RecordSet -Ipv4Address 172.31.255.255
Set-AzDnsRecordSet -RecordSet $RecordSet
# These cmdlets can also be piped:
Get-AzDnsRecordSet -ResourceGroupName MyResourceGroup -ZoneName myzone.com -Name www -RecordType A | Add-AzDnsRecordConfig -Ipv4Address 172.16.0.0 | Add-AzDnsRecordConfig -Ipv4Address 172.31.255.255 | Set-AzDnsRecordSet
最初のコマンドでは、Get-AzDnsRecordSet コマンドレットを使用して指定したレコード セットを取得し、$RecordSet変数に格納します。 2 番目と 3 番目のコマンドは、レコード セットに 2 つの A レコードを追加するオフライン操作です。 最後のコマンドでは 、Set-AzDnsRecordSet コマンドレットを使用して更新プログラムをコミットします。
例 2: SOA レコードを更新する
$Zone = Get-AzDnsZone -Name "myzone.com" -ResourceGroupName "MyResourceGroup"
$RecordSet = Get-AzDnsRecordSet -Name "@" -RecordType SOA -Zone $Zone
$RecordSet.Records[0].Email = "admin.myzone.com"
Set-AzDnsRecordSet -RecordSet $RecordSet
最初のコマンドでは 、Get-AzDnsRecordset コマンドレットを使用して指定したレコード セットを取得し、$RecordSet変数に格納します。 2 番目のコマンドは、$RecordSetで指定された SOA レコードを更新します。 最後のコマンドでは 、Set-AzDnsRecordSet コマンドレットを使用して、更新プログラムを$RecordSetに伝達します。
パラメーター
-Confirm
コマンドレットを実行する前に確認を求めるメッセージが表示されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | Cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
パラメーターのプロパティ
| 型: | IAzureContextContainer |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Overwrite
同時変更に関係なく、レコード セットを更新することを示します。 レコード セットは、ローカル RecordSet オブジェクトが取得されてからAzure DNSで変更された場合は更新されません。 これにより、同時変更の保護が提供されます。 この動作を抑制するには、 Overwrite パラメーターを使用すると、同時変更に関係なくレコード セットが更新されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RecordSet
更新する RecordSet を指定します。
パラメーターのプロパティ
| 型: | DnsRecordSet |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | False |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | wi |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、about_CommonParametersを参照してください。
入力
DnsRecordSet
出力
DnsRecordSet
メモ
Confirm パラメーターを使用して、このコマンドレットで確認を求めるメッセージを表示するかどうかを制御できます。 既定では、$ConfirmPreference Windows PowerShell 変数の値が中以下の場合、コマンドレットによって確認が求められます。 Confirm または Confirm:$True を指定した場合、このコマンドレットは実行前に確認を求められます。 Confirm:$False を指定した場合、コマンドレットは確認を求めません。
