Partilhar via


Set-SCVMNetwork

Modifica uma rede de máquina virtual.

Sintaxe

Set-SCVMNetwork
   [-UserRole <UserRole>]
   [-VMMServer <ServerConnection>]
   [-VMNetwork] <VMNetwork>
   [-Name <String>]
   [-Description <String>]
   [-Owner <String>]
   [-PortACL <PortACL>]
   [-RemovePortACL]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

O cmdlet Set-SCVMNetwork modifica as propriedades de uma rede de máquina virtual.

Para atualizar um objeto de rede de máquina virtual, use o cmdlet Get-SCVMNetwork.

Para obter mais informações sobre redes de máquinas virtuais, digite Get-Help New-SCVMNetwork -Detailed.

Exemplos

Exemplo 1: Adicionar uma descrição a uma rede de máquina virtual

PS C:\> Get-SCVMNetwork -Name "VMNetwork01" | Set-SCVMNetwork -Description "The first VM network"

Este comando obtém o objeto de rede de máquina virtual chamado VMNetwork01 usando o cmdlet Get-SCVMNetwork e, em seguida, usa o operador de pipeline para passar o objeto para Set-SCVMNetwork, que modifica a descrição do objeto de rede da máquina virtual.

Parâmetros

-Description

Especifica uma descrição para uma rede de máquina virtual.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-JobVariable

Especifica que o progresso do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica o nome de um objeto do Virtual Machine Manager (VMM).

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OnBehalfOfUser

Especifica um nome de usuário. Este cmdlet opera em nome do usuário especificado por esse parâmetro.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Este cmdlet opera em nome da função de usuário especificada por esse parâmetro.

Tipo:UserRole
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Owner

Especifica o proprietário de um objeto do VMM na forma de uma conta de usuário de domínio válida.

  • Exemplo de formato: -Owner "Contoso\PattiFuller"
  • Exemplo de formato: -Owner "PattiFuller@Contoso"
Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PortACL

Especifica uma ACL (lista de controle de acesso à porta).

Tipo:PortACL
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PROTipID

Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RemovePortACL

Indica que esta operação remove a ACL da porta.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-UserRole

Especifica um objeto de função de usuário.

Tipo:UserRole
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VMMServer

Especifica um objeto de servidor VMM.

Tipo:ServerConnection
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-VMNetwork

Especifica um objeto de rede de máquina virtual.

Para obter um objeto de rede de máquina virtual, use o cmdlet Get-SCVMNetwork.

Tipo:VMNetwork
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False