New-CsTenantUpdateTimeWindow

Use the New-CsTenantUpdateTimeWindow cmdlet to create a new tenant update time window.

Syntax

New-CsTenantUpdateTimeWindow
   [-Identity] <XdsGlobalRelativeIdentity>
   [-Tenant <Guid>]
   [-StartTime <TimeSpan>]
   [-Duration <TimeSpan>]
   [-InMemory]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CsTenantUpdateTimeWindow
   [-Identity] <XdsGlobalRelativeIdentity>
   [-Tenant <Guid>]
   [-Daily]
   [-StartTime <TimeSpan>]
   [-Duration <TimeSpan>]
   [-InMemory]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CsTenantUpdateTimeWindow
   [-Identity] <XdsGlobalRelativeIdentity>
   [-Tenant <Guid>]
   [-Weekly]
   [-StartTime <TimeSpan>]
   [-Duration <TimeSpan>]
   -DaysOfWeek <TenantUpdateTimeWindowDayOfWeek>
   [-InMemory]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CsTenantUpdateTimeWindow
   [-Identity] <XdsGlobalRelativeIdentity>
   [-Tenant <Guid>]
   [-Monthly]
   [-StartTime <TimeSpan>]
   [-Duration <TimeSpan>]
   -DayOfMonth <Int32>
   [-InMemory]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CsTenantUpdateTimeWindow
   [-Identity] <XdsGlobalRelativeIdentity>
   [-Tenant <Guid>]
   [-Monthly]
   [-StartTime <TimeSpan>]
   [-Duration <TimeSpan>]
   -WeeksOfMonth <TenantUpdateTimeWindowWeekOfMonth>
   -DaysOfWeek <TenantUpdateTimeWindowDayOfWeek>
   [-InMemory]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Tenant update time windows are created, retrieved, modified and deleted by the CsTenantUpdateTimeWindow cmdlet group (New, Get, Set and Remove). The tenant update time windows can be reviewed in your hybrid configuration by using the Get-CsTenantHybridConfiguration cmdlet. However, you can't create or modify tenant update time windows through the CsTenantHybridConfiguration cmdlets. You must use the CsTenantUpdateTimeWindow cmdlets to manage tenant update time windows.

To return a list of all the Role-Based Access Control (RBAC) roles a cmdlet has been assigned, run the following command:

Get-CsAdminRole | Where-Object {$_.Cmdlets -Match "\<CmdletName\>"}

Examples

-------------------------- Example 1 --------------------------

New-CsTenantUpdateTimeWindow -Identity FirstAndLastWeekend -Monthly -WeeksOfMonth First,Last -DaysOfWeek Sunday,Saturday -StartTime 1:00 -Duration 5:00

This example creates a new tenant update time window in the tenant in Monthly type.

-------------------------- Example 2 --------------------------

New-CsTenantUpdateTimeWindow -Identity MidDay -Monthly -DayOfMonth 15 -StartTime 5:00 -Duration 6:00

This example creates a new tenant update time window in the tenant in Monthly type.

-------------------------- Example 3 --------------------------

New-CsTenantUpdateTimeWindow -Identity Weekday -Weekly -DaysOfWeek Monday,Tuesday,Wednesday,Thursday,Friday -StartTime 3:00 -Duration 10:00

This example creates a new tenant update time window in the tenant in Weekly type.

-------------------------- Example 4 --------------------------

New-CsTenantUpdateTimeWindow -Identity Night -Daily

This example creates a new tenant update time window in the tenant in Daily type.

Parameters

-Confirm

PARAMVALUE: SwitchParameter

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-Daily

Type of Time window is daily.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-DayOfMonth

Day of month. It must be defined when Type is Monthly.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-DaysOfWeek

Days of week. It can be multiple days separated by a comma. It must be defined when Type is Weekly or Monthly.

Type:TenantUpdateTimeWindowDayOfWeek
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-Duration

Duration of the update time window.

Type:TimeSpan
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-Force

The Force switch specifies whether to suppress warning and confirmation messages. It can be useful in scripting to suppress interactive prompts. If the Force switch isn't provided in the command, you're prompted for administrative input if required.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-Identity

Specifies the identity of the tenant update time window.

Type:XdsGlobalRelativeIdentity
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-InMemory

PARAMVALUE: SwitchParameter

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-Monthly

Type of Time window is monthly.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-StartTime

Time of day when the update time window starts.

Type:TimeSpan
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-Tenant

PARAMVALUE: Guid

Type:Guid
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-Weekly

Type of Time window is weekly.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-WeeksOfMonth

Weeks of month. It can be multiple weeks separated by a comma. It must be defined when Type is Monthly.

Type:TenantUpdateTimeWindowWeekOfMonth
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online
-WhatIf

PARAMVALUE: SwitchParameter

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Skype for Business Online