Get-SCVirtualScsiAdapter
Obtém um objeto de adaptador SCSI virtual do VMM de uma máquina virtual, modelo de máquina virtual ou perfil de hardware.
Sintaxe
All
Get-SCVirtualScsiAdapter
[-VMMServer <ServerConnection>]
[-All]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
HardwareProfile
Get-SCVirtualScsiAdapter
-HardwareProfile <HardwareProfile>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
VM
Get-SCVirtualScsiAdapter
-VM <VM>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Template
Get-SCVirtualScsiAdapter
-VMTemplate <Template>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
ID
Get-SCVirtualScsiAdapter
[-ID] <Guid>
[-VMMServer <ServerConnection>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]
Description
O cmdlet Get-SCVirtualScsiAdapter obtém um ou mais objetos de adaptador SCSI virtual usados em um ambiente do VMM (Virtual Machine Manager) de um objeto de máquina virtual, um objeto de modelo de máquina virtual ou de um objeto de perfil de hardware.
Uma máquina virtual em um host Citrix XenServer sempre tem um adaptador SCSI virtual. Não é possível remover esse adaptador ou adicionar adaptadores adicionais.
Exemplos
Exemplo 1: Obter todos os adaptadores SCSI virtuais em uma máquina virtual
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Get-SCVirtualScsiAdapter -VM $VM
O primeiro comando obtém o objeto de máquina virtual chamado VM01 e armazena o objeto na variável $VM.
O segundo comando obtém todos os objetos do adaptador SCSI virtual na VM01 e exibe informações sobre os adaptadores para o usuário.
Exemplo 2: Obter todos os adaptadores SCSI virtuais em um modelo de máquina virtual
PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> Get-SCVirtualScsiAdapter -VMTemplate $VMTemplate
O primeiro comando obtém o objeto de modelo de máquina virtual chamado VMTemplate01 da biblioteca do VMM e armazena o objeto na variável $VMTemplate.
O segundo comando obtém todos os objetos do adaptador SCSI virtual em VMTemplate01 e exibe informações sobre os adaptadores para o usuário.
Exemplo 3: Obter todos os adaptadores SCSI virtuais de um perfil de hardware
PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> Get-SCVirtualScsiAdapter -HardwareProfile $HWProfile
O primeiro comando obtém o objeto de perfil de hardware chamado NewHWProfile01 da biblioteca do VMM e armazena o objeto na variável $HWProfile.
O segundo comando obtém todos os objetos do adaptador SCSI em NewHWProfile01 e exibe informações sobre os adaptadores para o usuário.
Parâmetros
-All
Indica que esse cmdlet obtém todos os objetos subordinados independentemente do objeto pai.
Por exemplo, o comando Get-SCVirtualDiskDrive -All obtém todos os objetos de unidade de disco virtual, independentemente do objeto de máquina virtual ou objeto de modelo ao qual cada objeto de unidade de disco virtual está associado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
All
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-HardwareProfile
Especifica um objeto de perfil de hardware.
Propriedades do parâmetro
| Tipo: | HardwareProfile |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
HardwareProfile
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ID
Especifica o identificador numérico como um identificador global exclusivo, ou GUID, para um objeto específico.
Propriedades do parâmetro
| Tipo: | Guid |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ID
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-OnBehalfOfUser
Especifica o nome de um usuário. Esse cmdlet define o nome do usuário como o usuário especificado por esse parâmetro.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-OnBehalfOfUserRole
Especifica uma função de usuário. Esse cmdlet define a função em nome do usuário como a função de usuário especificada por esse parâmetro. Para obter um objeto de função de usuário, use o cmdlet Get-SCUserRole.
Propriedades do parâmetro
| Tipo: | UserRole |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-VM
Especifica um objeto de máquina virtual.
Propriedades do parâmetro
| Tipo: | VM |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
VM
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-VMMServer
Especifica um objeto de servidor do VMM.
Propriedades do parâmetro
| Tipo: | ServerConnection |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-VMTemplate
Especifica um objeto de modelo do VMM usado para criar máquinas virtuais.
Propriedades do parâmetro
| Tipo: | Template |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | Modelo |
Conjuntos de parâmetros
Template
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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
VirtualSCSIAdapter
Esse cmdlet retorna um objeto VirtualSCSIAdapter.
Observações
- Requer um objeto de máquina virtual do VMM, um objeto de modelo de máquina virtual ou um objeto de perfil de hardware, que pode ser recuperado usando o Get-SCVirtualMachine, Get-SCVMTemplateou Get-SCHardwareProfile cmdlets, respectivamente.