Update-RDVirtualDesktopCollection

아티클
11/16/2015

Update-RDVirtualDesktopCollection

Associates a virtual desktop collection with a new virtual desktop template.

구문

Parameter Set: Now
Update-RDVirtualDesktopCollection [-CollectionName] <String> -VirtualDesktopTemplateHostServer <String> -VirtualDesktopTemplateName <String> [-ConnectionBroker <String> ] [-DisableVirtualDesktopRollback] [-Force] [-VirtualDesktopPasswordAge <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: OnSchedule
Update-RDVirtualDesktopCollection [-CollectionName] <String> -ForceLogoffTime <DateTime> -VirtualDesktopTemplateHostServer <String> -VirtualDesktopTemplateName <String> [-ConnectionBroker <String> ] [-DisableVirtualDesktopRollback] [-Force] [-VirtualDesktopPasswordAge <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: OnUserLogoff
Update-RDVirtualDesktopCollection [-CollectionName] <String> -ForceLogoffTime <DateTime> -StartTime <DateTime> -VirtualDesktopTemplateHostServer <String> -VirtualDesktopTemplateName <String> [-ConnectionBroker <String> ] [-DisableVirtualDesktopRollback] [-Force] [-VirtualDesktopPasswordAge <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

자세한 설명

The Update-RDVirtualDesktopCollection cmdlet associates an existing virtual desktop collection with a new virtual desktop template.

매개 변수

-CollectionName<String>

Specifies the name of a virtual desktop collection.

별칭	없음
필수 여부	true
위치	1
기본값	없음
파이프라인 입력 적용 여부	True (ByPropertyName)
와일드카드 문자 허용 여부	false

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

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-DisableVirtualDesktopRollback

Indicates that the server prevents the rollback of a virtual desktop deployment.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-Force

Performs the action without a confirmation message.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-ForceLogoffTime<DateTime>

Specifies a date and time by which the server ends the session if the operation is still running.

별칭	없음
필수 여부	true
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-StartTime<DateTime>

Specifies a date and time to start the operation.

별칭	없음
필수 여부	true
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-VirtualDesktopPasswordAge<Int32>

Specifies the number of days after which the server forces a password update for the computer account.

별칭	없음
필수 여부	false
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-VirtualDesktopTemplateHostServer<String>

Specifies the fully qualified domain name (FQDN) of the server where the virtual desktop template associated with the collection is stored.

별칭	없음
필수 여부	true
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-VirtualDesktopTemplateName<String>

Specifies a descriptive name for the virtual desktop template.

별칭	없음
필수 여부	true
위치	named
기본값	없음
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

필수 여부	false
위치	named
기본값	false
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

필수 여부	false
위치	named
기본값	false
파이프라인 입력 적용 여부	false
와일드카드 문자 허용 여부	false

<CommonParameters>

이 cmdlet은 일반 매개 변수 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer 및 -OutVariable을 지원합니다. 자세한 내용은 다음을 참조하세요. about_CommonParameters(https://go.microsoft.com/fwlink/p/?LinkID=113216).

입력

입력 유형은 cmdlet에 파이프할 수 있는 개체의 유형입니다.

출력

출력 유형은 cmdlet이 내보내는 개체의 유형입니다.

System.Object

예제

Example 1: Update a virtual desktop collection

This command updates the virtual desktop collection named "Virtual Desktop pool" with the virtual desktop template named "RDS-Template" on the host server named "rdvh-1.contoso.com".

The command specifies that the server ends the session if the update operation is still running at 12:00am. The command disables the rollback of a virtual desktop deployment and specifies that the server forces a password update for the computer account for a virtual desktop after 31 days.

PS C:\> Update-RDVirtualDesktopCollection -CollectionName "Virtual Desktop pool" VirtualDesktopTemplateName "RDS-Template" -VirtualDesktopTemplateHostServer "rdvh-1.contoso.com" -ForceLogoffTime 12:00am -DisableVirtualDesktopRollback -VirtualDesktopPasswordAge 31 -ConnectionBroker "rdcb.contoso.com"

Update-RDVirtualDesktopCollection