Update-AzNetworkCloudVirtualMachine
Atualize uma nova máquina virtual ou atualize as propriedades da máquina virtual existente.
Sintaxe
UpdateExpanded (Predefinição)
Update-AzNetworkCloudVirtualMachine
-Name <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
[-IfMatch <String>]
[-IfNoneMatch <String>]
[-EnableSystemAssignedIdentity <Boolean>]
[-Tag <Hashtable>]
[-UserAssignedIdentity <String[]>]
[-VMImageRepositoryCredentialsPassword <SecureString>]
[-VMImageRepositoryCredentialsRegistryUrl <String>]
[-VMImageRepositoryCredentialsUsername <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
UpdateViaIdentityExpanded
Update-AzNetworkCloudVirtualMachine
-InputObject <INetworkCloudIdentity>
[-IfMatch <String>]
[-IfNoneMatch <String>]
[-EnableSystemAssignedIdentity <Boolean>]
[-Tag <Hashtable>]
[-UserAssignedIdentity <String[]>]
[-VMImageRepositoryCredentialsPassword <SecureString>]
[-VMImageRepositoryCredentialsRegistryUrl <String>]
[-VMImageRepositoryCredentialsUsername <String>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrição
Atualize uma nova máquina virtual ou atualize as propriedades da máquina virtual existente.
Exemplos
Exemplo 1: Atualizar máquina virtual
$tagUpdatedHash = @{
tag1 = "tag1"
tag2 = "tag1Update"
}
$registryPassword = ConvertTo-SecureString "password" -asplaintext -force
Update-AzNetworkCloudVirtualMachine -Name vmName -ResourceGroupName resourceGroup -Tag $tagUpdatedHash -VMImageRepositoryCredentialsRegistryUrl registryUrl -VMImageRepositoryCredentialsUsername registryUsername -VMImageRepositoryCredentialsPassword $registryPassword
Location Name SystemDataCreatedAt SystemDataCreatedBy SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy SystemDataL
astModified
ByType
-------- ---- ------------------- ------------------- ----------------------- ------------------------ ------------------------ -----------
eastus default 07/07/2023 21:29:03 <user> User 07/07/2023 21:32:41 <identity> Application
Este comando atualiza as propriedades de uma máquina virtual.
Parâmetros
-AsJob
Executar o comando como um trabalho
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Aliases: Cf.
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-DefaultProfile
O parâmetro DefaultProfile não é funcional.
Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.
Propriedades dos parâmetros
Tipo: PSObject
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Aliases: AzureRMContext, AzureCredential
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-EnableSystemAssignedIdentity
Determina se uma identidade atribuída pelo sistema deve ser habilitada para o recurso.
Propriedades dos parâmetros
Tipo: Nullable<T> [ Boolean ]
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-IfMatch
O ETag da transformação.
Omita esse valor para sempre substituir o recurso atual.
Especifique o valor ETag visto pela última vez para evitar a substituição acidental de alterações simultâneas.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-IfNoneMatch
Defina como '*' para permitir que um novo conjunto de registros seja criado, mas para impedir a atualização de um recurso existente.
Outros valores resultarão em erro do servidor, pois não são suportados.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
Parâmetro de identidade
UpdateViaIdentityExpanded
Posto: Named
Obrigatório: True
Valor do pipeline: True
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-Name
O nome da máquina virtual.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Aliases: VirtualMachineName
Conjuntos de parâmetros
UpdateExpanded
Posto: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-NoWait
Execute o comando de forma assíncrona
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-ResourceGroupName
O nome do grupo de recursos.
O nome não distingue maiúsculas de minúsculas.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
UpdateExpanded
Posto: Named
Obrigatório: True
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-SubscriptionId
O ID da assinatura de destino.
O valor deve ser um UUID.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: (Get-AzContext).Subscription.Id
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
UpdateExpanded
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-Tag
Tags de recursos.
Propriedades dos parâmetros
Tipo: Hashtable
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-UserAssignedIdentity
A matriz de identidades atribuídas pelo usuário associadas ao recurso.
Os elementos no array serão IDs de recursos ARM na forma: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}.'
Propriedades dos parâmetros
Tipo: String [ ]
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-VMImageRepositoryCredentialsPassword
A senha ou token usado para acessar uma imagem no repositório de destino.
Propriedades dos parâmetros
Tipo: SecureString
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-VMImageRepositoryCredentialsRegistryUrl
A URL do servidor de autenticação usado para validar as credenciais do repositório.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-VMImageRepositoryCredentialsUsername
O nome de usuário usado para acessar uma imagem no repositório de destino.
Propriedades dos parâmetros
Tipo: String
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades dos parâmetros
Tipo: SwitchParameter
Valor predefinido: None
Suporta carateres universais: False
NãoMostrar: False
Aliases: Wi
Conjuntos de parâmetros
(All)
Posto: Named
Obrigatório: False
Valor do pipeline: False
Valor do pipeline por nome de propriedade: False
Valor dos restantes argumentos: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas