Set-AzPrivateDnsVirtualNetworkLink
更新/設定與私人區域和資源群組相關聯的虛擬網路連結。
語法
Fields (預設值)
Set-AzPrivateDnsVirtualNetworkLink
-ResourceGroupName <String>
-ZoneName <String>
-Name <String>
[-IsRegistrationEnabled <Boolean>]
[-ResolutionPolicy <String>]
[-Tag <Hashtable>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Object
Set-AzPrivateDnsVirtualNetworkLink
-InputObject <PSPrivateDnsVirtualNetworkLink>
[-IsRegistrationEnabled <Boolean>]
[-ResolutionPolicy <String>]
[-Tag <Hashtable>]
[-Overwrite]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ResourceId
Set-AzPrivateDnsVirtualNetworkLink
-ResourceId <String>
[-IsRegistrationEnabled <Boolean>]
[-ResolutionPolicy <String>]
[-Tag <Hashtable>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Set-AzPrivateDnsVirtualNetworkLink Cmdlet 會更新與指定資源群組中區域相關聯的連結。
您可以使用 Link 參數或使用管線運算子傳遞 PSPrivateDnsVirtualNetworkLink 物件,或者您可以指定 NameZoneName 和 ResourceGroupName 參數。
您可以使用 Confirm 參數和$ConfirmPreference Windows PowerShell 變數來控制 Cmdlet 是否提示您確認。
使用 PSPrivateDnsVirtualNetworkLink 物件指定區域時 (透過管線或 Link 參數傳遞) ,如果自擷取本機 PSPrivateDnsVirtualNetworkLink 物件以來,已在 Azure DNS 中變更連結,則不會更新連結。 這為並發鏈路更改提供了保護。 可以使用 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
ResolutionPolicy : Default
VirtualNetworkLinkState : Completed
ProvisioningState : Succeeded
此命令會針對名為 mylink 的連結設定 IsRegistrationEnabled 為 True,連結至名為 MyResourceGroup 的資源群組中名為 myzone.com 的區域。
參數
-Confirm
在執行 Cmdlet 之前,提示您進行確認。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
要設定的虛擬網路連結物件。
Object
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IsRegistrationEnabled
布林值,代表是否在虛擬網路連結上啟用註冊。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
指定此 Cmdlet 移除的連結名稱。
您也必須指定 ResourceGroupName 和 ZoneName 參數。
或者,您可以使用 link 參數來指定專用 DNS 連結。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Fields
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Overwrite
使用 PSPrivateDnsVirtualNetworkLink 物件指定連結時 (透過管線或 Link 參數傳遞) ,如果自擷取本機 PSPrivateDnsVirtualNetworkLink 物件以來,已在 Azure DNS 中變更連結,則不會刪除連結。
這為並發鏈路更改提供了保護。
可以使用 Overwrite 參數來抑制此情況,無論並行變更為何,該參數都會刪除連結。
參數屬性
參數集
Object
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ResolutionPolicy
指定虛擬網路連結的解析原則
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ResourceGroupName
指定包含要移除之鏈結的資源群組名稱。
您也必須指定 ZoneName 和 Name 參數。
或者,您可以使用 PSPrivateDnsVirtualNetworkLink 物件來指定虛擬網路連結,透過管線或 Link 參數傳遞。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Fields
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ResourceId
私人 DNS 區域 ResourceID。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
ResourceId
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Tag
代表資源標籤的雜湊表。
參數屬性
| 類型: | Hashtable
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。
指令未執行。
參數屬性
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ZoneName
指定此 Cmdlet 移除的 DNS 區域名稱。
您也必須指定 Name 和 ResourceGroupName 參數。
或者,您可以使用 link 參數來指定專用 DNS 連結。
參數屬性
| 類型: | String
|
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
Fields
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。
輸出