你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Set-AzPrivateDnsVirtualNetworkLink
更新/设置与专用区域和资源组关联的虚拟网络链接。
语法
Set-AzPrivateDnsVirtualNetworkLink
-ResourceGroupName <String>
-ZoneName <String>
-Name <String>
[-IsRegistrationEnabled <Boolean>]
[-Tag <Hashtable>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzPrivateDnsVirtualNetworkLink
-InputObject <PSPrivateDnsVirtualNetworkLink>
[-IsRegistrationEnabled <Boolean>]
[-Tag <Hashtable>]
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzPrivateDnsVirtualNetworkLink
-ResourceId <String>
[-IsRegistrationEnabled <Boolean>]
[-Tag <Hashtable>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Set-AzPrivateDnsVirtualNetworkLink cmdlet 更新与指定资源组中的区域关联的链接。 可以使用 Link 参数或使用管道运算符传递 PSPrivateDnsVirtualNetworkLink 对象,也可以指定 Name ZoneName 和 ResourceGroupName 参数。 可以使用 Confirm 参数和 $ConfirmPreference Windows PowerShell 变量来控制 cmdlet 是否提示你进行确认。 使用 PSPrivateDnsVirtualNetworkLink 对象(通过管道或 Link 参数传递)指定区域时,如果在 Azure DNS 中更改了该区域,则链接不会更新,因为检索了本地 PSPrivateDnsVirtualNetworkLink 对象。 这为并发链接更改提供保护。 可以使用 Overwrite 参数取消此操作,无论并发更改如何,都会更新链接。
示例
示例 1:设置链接
Set-AzPrivateDnsVirtualNetworkLink -ZoneName "myzone.com" -ResourceGroupName "MyResourceGroup" -Name "mylink" -Tag @{} -IsRegistrationEnabled $true
Name : mylink
ResourceId : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.N
etwork/privateDnsZones/myzone.com/virtualNetworkLinks/mylink
ResourceGroupName : MyResourceGroup
ZoneName : myzone.com
VirtualNetworkId : /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/MyResourceGroup/providers/Microsoft.N
etwork/virtualNetworks/myvirtualnetwork
Location :
Etag : "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
Tags : {}
RegistrationEnabled : True
VirtualNetworkLinkState : Completed
ProvisioningState : Succeeded
此命令将名为 mylink 的链接的 IsRegistrationEnabled 设置为 True,并将其链接到名为 MyResourceGroup 的资源组 myzone.com 的区域。
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DefaultProfile
用于与 azure 通信的凭据、帐户、租户和订阅
类型: | IAzureContextContainer |
别名: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-InputObject
要设置的虚拟网络链接对象。
类型: | PSPrivateDnsVirtualNetworkLink |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-IsRegistrationEnabled
表示是否在虚拟网络链接上启用了注册的布尔值。
类型: | Nullable<T>[Boolean] |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Name
指定此 cmdlet 删除的链接的名称。 还必须指定 ResourceGroupName 和 ZoneName 参数。 或者,可以使用链接参数指定专用 DNS 链接。
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-Overwrite
使用 PSPrivateDnsVirtualNetworkLink 对象(通过管道或 Link 参数传递)指定链接时,如果在 Azure DNS 中更改链接,则不会删除该链接,因为检索了本地 PSPrivateDnsVirtualNetworkLink 对象。 这为并发链接更改提供保护。 可以使用 Overwrite 参数取消此操作,无论并发更改如何,都会删除链接。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ResourceGroupName
指定包含要删除的链接的资源组的名称。 还必须指定 ZoneName 和 Name 参数。 或者,可以使用通过管道或 Link 参数传递的 PSPrivateDnsVirtualNetworkLink 对象指定虚拟网络链接。
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-ResourceId
私人 DNS区域 ResourceID。
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-Tag
表示资源标记的哈希表。
类型: | Hashtable |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ZoneName
指定此 cmdlet 删除的 DNS 区域的名称。 还必须指定 Name 和 ResourceGroupName 参数。 或者,可以使用链接参数指定专用 DNS 链接。
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
输入
PSPrivateDnsVirtualNetworkLink
输出
PSPrivateDnsVirtualNetworkLink