Update-RDVirtualDesktopCollection
업데이트 날짜: 2015년 6월
적용 대상: Windows 10, Windows Server Technical Preview
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] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-VirtualDesktopPasswordAge <Int32> ] [ <CommonParameters>]
Parameter Set: OnSchedule
Update-RDVirtualDesktopCollection [-CollectionName] <String> -ForceLogoffTime <DateTime> -VirtualDesktopTemplateHostServer <String> -VirtualDesktopTemplateName <String> [-ConnectionBroker <String> ] [-DisableVirtualDesktopRollback] [-Force] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-VirtualDesktopPasswordAge <Int32> ] [ <CommonParameters>]
Parameter Set: OnUserLogoff
Update-RDVirtualDesktopCollection [-CollectionName] <String> -ForceLogoffTime <DateTime> -StartTime <DateTime> -VirtualDesktopTemplateHostServer <String> -VirtualDesktopTemplateName <String> [-ConnectionBroker <String> ] [-DisableVirtualDesktopRollback] [-Force] [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-VirtualDesktopPasswordAge <Int32> ] [ <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.
별칭 |
none |
필수 여부 |
true |
위치 |
1 |
기본값 |
none |
파이프라인 입력 허용 여부 |
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.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-DisableVirtualDesktopRollback
Indicates that the server prevents the rollback of a virtual desktop deployment.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-Force
사용자에게 확인 메시지를 표시하지 않고 명령을 강제 실행합니다.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-ForceLogoffTime<DateTime>
Specifies a date and time by which the server ends the session if the operation is still running.
별칭 |
none |
필수 여부 |
true |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
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
별칭 |
infa |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-InformationVariable<System.String>
Specifies a variable in which to store an information event message.
별칭 |
iv |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-StartTime<DateTime>
Specifies a date and time to start the operation.
별칭 |
none |
필수 여부 |
true |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-VirtualDesktopPasswordAge<Int32>
Specifies the number of days after which the server forces a password update for the computer account.
별칭 |
none |
필수 여부 |
false |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
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.
별칭 |
none |
필수 여부 |
true |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
-VirtualDesktopTemplateName<String>
Specifies a descriptive name for the virtual desktop template.
별칭 |
none |
필수 여부 |
true |
위치 |
named |
기본값 |
none |
파이프라인 입력 허용 여부 |
false |
와일드카드 문자 허용 여부 |
false |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 TechNet의 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"
관련 항목
Get-RDVirtualDesktopCollection