Compartilhar via


Set-AzPrivateDnsVirtualNetworkLink

Atualiza/define um link de rede virtual associado a uma zona privada e a um grupo de recursos.

Sintaxe

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>]

Description

O cmdlet Set-AzPrivateDnsVirtualNetworkLink atualiza um link associado a uma zona de um grupo de recursos especificado. Você pode passar um objeto PSPrivateDnsVirtualNetworkLink usando o parâmetro Link ou usando o operador de pipeline ou, como alternativa, pode especificar os parâmetros Name ZoneName e ResourceGroupName . Você pode usar o parâmetro Confirm e $ConfirmPreference variável do Windows PowerShell para controlar se o cmdlet solicita a confirmação. Ao especificar a zona usando um objeto PSPrivateDnsVirtualNetworkLink (passado por meio do pipeline ou do parâmetro Link), o link não será atualizado se tiver sido alterado no DNS do Azure desde que o objeto PSPrivateDnsVirtualNetworkLink local foi recuperado. Isso fornece proteção para alterações simultâneas de link. Isso pode ser suprimido usando o parâmetro Overwrite , que atualiza o link independentemente das alterações simultâneas.

Exemplos

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

Esse comando define IsRegistrationEnabled como True para o link chamado mylink, vinculado à zona chamada myzone.com do grupo de recursos chamado MyResourceGroup.

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usadas para comunicação com o Azure

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

O objeto de link de rede virtual a ser definido.

Tipo:PSPrivateDnsVirtualNetworkLink
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-IsRegistrationEnabled

Booleano que representa se o registro está habilitado no link de rede virtual.

Tipo:Nullable<T>[Boolean]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica o nome do link que esse cmdlet remove. Você também deve especificar o parâmetro ResourceGroupName e ZoneName . Como alternativa, você pode especificar o link DNS privado usando o parâmetro link .

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Overwrite

Ao especificar o link usando um objeto PSPrivateDnsVirtualNetworkLink (passado por meio do pipeline ou do parâmetro Link), o link não será excluído se tiver sido alterado no DNS do Azure desde que o objeto PSPrivateDnsVirtualNetworkLink local foi recuperado. Isso fornece proteção para alterações simultâneas de link. Isso pode ser suprimido usando o parâmetro Overwrite , que exclui o link independentemente das alterações simultâneas.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceGroupName

Especifica o nome do grupo de recursos que contém o link a ser removido. Você também deve especificar o parâmetro ZoneName e Name. Como alternativa, você pode especificar o link de rede virtual usando um objeto PSPrivateDnsVirtualNetworkLink , passado por meio do pipeline ou do parâmetro Link .

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceId

ResourceID da zona DNS privada.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Tag

Uma tabela de hash que representa marcas de recursos.

Tipo:Hashtable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ZoneName

Especifica o nome da zona DNS que esse cmdlet remove. Você também deve especificar o parâmetro Name e ResourceGroupName . Como alternativa, você pode especificar o link DNS privado usando o parâmetro link .

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

PSPrivateDnsVirtualNetworkLink

String

Saídas

PSPrivateDnsVirtualNetworkLink