Compartilhar via


New-RDVirtualDesktopDeployment

Aplica-se a: Windows 10, Windows Server Technical Preview

New-RDVirtualDesktopDeployment

Installs role services for Virtual Desktop Infrastructure.

Sintaxe

Parameter Set: Default
New-RDVirtualDesktopDeployment [-ConnectionBroker] <String> [-VirtualizationHost] <String[]> [[-WebAccessServer] <String> ] [[-CreateVirtualSwitch]] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [ <CommonParameters>]

Descrição detalhada

The New-RDVirtualDesktopDeployment cmdlet installs the role services that Virtual Desktop Infrastructure (VDI) requires to create a virtual machine-based desktop deployment. You can specify the CreateVirtualSwitch parameter to create a pooled virtual desktop collection in addition to installing the role services.

In Windows Server® 2012, the Microsoft Virtual Desktop Infrastructure (VDI) deployment is a scenario-based installation that allows you to install, configure, and manage your virtual desktops from a central location.

Parâmetros

-ConnectionBroker<String>

Specifies the Remote Desktop Connection Broker (RD Connection Broker) server for a remote desktop deployment. If you do not specify a value, the cmdlet uses the fully qualified domain name (FQDN) of the local computer.

Aliases

none

Obrigatório?

true

Posição?

1

Valor padrão

none

Aceitar entrada de pipeline?

false

Aceitar caracteres curinga?

false

-CreateVirtualSwitch

Indicates that VDI creates a pooled virtual desktop collection that is based on a virtual hard disk of the virtual desktop template.

Aliases

none

Obrigatório?

false

Posição?

4

Valor padrão

none

Aceitar entrada de pipeline?

false

Aceitar caracteres curinga?

false

-InformationAction<System.Management.Automation.ActionPreference>

Specifies how this cmdlet responds to an information event. The acceptable values for this parameter are:

-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend

Aliases

infa

Obrigatório?

false

Posição?

named

Valor padrão

none

Aceitar entrada de pipeline?

false

Aceitar caracteres curinga?

false

-InformationVariable<System.String>

Specifies a variable in which to store an information event message.

Aliases

iv

Obrigatório?

false

Posição?

named

Valor padrão

none

Aceitar entrada de pipeline?

false

Aceitar caracteres curinga?

false

-VirtualizationHost<String[]>

Specifies the fully qualified domain name (FQDN) of the server that you want to run the Virtualization Host (RD Virtualization Host) role service.

Aliases

none

Obrigatório?

true

Posição?

2

Valor padrão

none

Aceitar entrada de pipeline?

false

Aceitar caracteres curinga?

false

-WebAccessServer<String>

Specifies the fully qualified domain name (FQDN) of the server that you want to run the Remote Desktop Web Access (RD Web Access) role service.

Aliases

none

Obrigatório?

false

Posição?

3

Valor padrão

none

Aceitar entrada de pipeline?

false

Aceitar caracteres curinga?

false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte  about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entradas

O tipo de entrada é o tipo dos objetos que você pode redirecionar para o cmdlet.

Saídas

O tipo de saída é o tipo de objeto que o cmdlet emite.

  • Null

Exemplos

Example 1: Create a virtual desktop deployment

This command installs the role services that Virtual Desktop Infrastructure (VDI) requires to create a virtual machine-based desktop deployment. The command uses the CreateVirtualSwitch parameter to create a pooled virtual desktop collection.

PS C:\> New-RDVirtualDesktopDeployment -ConnectionBroker "rdcb.contoso.com" -WebAccessServer "rdwa.contoso.com" -VirtualizationHost "rdsh.contoso.com" -CreateVirtualSwitch

Example 2: Install role services for Virtual Desktop Infrastructure

This command installs the role services that Virtual Desktop Infrastructure (VDI) requires to create a virtual machine-based desktop deployment. The command installs the Remote Desktop Web Access (RD Web Access) role service on the server named rdwa.contoso.com, and installs the Virtualization Host (RD Virtualization Host) role service on the servers named rdsh-1.contoso.com and rdsh-2.contoso.com. The command does not create a pooled virtual desktop collection.

PS C:\> New-RDVirtualDesktopDeployment -ConnectionBroker "rdcb.contoso.com" -WebAccessServer "rdwa.contoso.com" -VirtualizationHost @("rdsh-1.contoso.com","rdsh-2.contoso.com")

Tópicos relacionados

New-RDSessionDeployment