Set-CsTenantUpdateTimeWindow
Use the Set-CsTenantUpdateTimeWindow cmdlet to modify an existing tenant update time window's attributes.
Syntax
Identity (Default)
Set-CsTenantUpdateTimeWindow
[-Identity] <XdsGlobalRelativeIdentity>
[-Tenant <Guid>]
[-StartTime <TimeSpan>]
[-Duration <TimeSpan>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Daily
Set-CsTenantUpdateTimeWindow
[-Identity] <XdsGlobalRelativeIdentity>
[-Tenant <Guid>]
[-Daily]
[-StartTime <TimeSpan>]
[-Duration <TimeSpan>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Weekly
Set-CsTenantUpdateTimeWindow
[-Identity] <XdsGlobalRelativeIdentity>
-DaysOfWeek <TenantUpdateTimeWindowDayOfWeek>
[-Tenant <Guid>]
[-Weekly]
[-StartTime <TimeSpan>]
[-Duration <TimeSpan>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
MonthlyByDate
Set-CsTenantUpdateTimeWindow
[-Identity] <XdsGlobalRelativeIdentity>
-DayOfMonth <Int32>
[-Tenant <Guid>]
[-Monthly]
[-StartTime <TimeSpan>]
[-Duration <TimeSpan>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
MonthlyByWeekDay
Set-CsTenantUpdateTimeWindow
[-Identity] <XdsGlobalRelativeIdentity>
-WeeksOfMonth <TenantUpdateTimeWindowWeekOfMonth>
-DaysOfWeek <TenantUpdateTimeWindowDayOfWeek>
[-Tenant <Guid>]
[-Monthly]
[-StartTime <TimeSpan>]
[-Duration <TimeSpan>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Instance
Set-CsTenantUpdateTimeWindow
[-Identity] <XdsGlobalRelativeIdentity>
[-Tenant <Guid>]
[-StartTime <TimeSpan>]
[-Duration <TimeSpan>]
[-Instance <PSObject>]
[-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
Set-CsTenantUpdateTimeWindow -Identity FirstAndLastWeekend -Monthly -WeeksOfMonth First,Last -DaysOfWeek Sunday,Saturday -StartTime 1:00 -Duration 5:00
This example updates an existing tenant update time window in the tenant in Monthly type.
Example 2
Set-CsTenantUpdateTimeWindow -Identity MidDay -Monthly -DayOfMonth 15 -StartTime 5:00 -Duration 6:00
This example updates an existing tenant update time window in the tenant in Monthly type.
Example 3
Set-CsTenantUpdateTimeWindow -Identity Weekday -Weekly -DaysOfWeek Monday,Tuesday,Wednesday,Thursday,Friday -StartTime 3:00 -Duration 10:00
This example updates an existing tenant update time window in the tenant in Weekly type.
Example 4
Set-CsTenantUpdateTimeWindow -Identity Night -Daily
This example updates an existing tenant update time window in the tenant in Daily type.
Parameters
-Confirm
Applicable: Skype for Business Online
PARAMVALUE: SwitchParameter
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Daily
Applicable: Skype for Business Online
Type of Time window is daily.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-DayOfMonth
Applicable: Skype for Business Online
Day of month. It must be defined when Type is Monthly.
Parameter properties
| Type: | Int32 |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-DaysOfWeek
Applicable: Skype for Business Online
Days of week. It can be multiple days separated by a comma. It must be defined when Type is Weekly or Monthly.
Parameter properties
| Type: | TenantUpdateTimeWindowDayOfWeek |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Duration
Applicable: Skype for Business Online
Duration of the update time window.
Parameter properties
| Type: | TimeSpan |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Force
Applicable: Skype for Business Online
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.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Identity
Applicable: Skype for Business Online
Specifies the identity of the tenant update time window.
Parameter properties
| Type: | XdsGlobalRelativeIdentity |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 2 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Instance
Applicable: Skype for Business Online
PARAMVALUE: PSObject
Parameter properties
| Type: | PSObject |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Monthly
Applicable: Skype for Business Online
Type of Time window is monthly.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-StartTime
Applicable: Skype for Business Online
Time of day when the update time window starts.
Parameter properties
| Type: | TimeSpan |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Tenant
Applicable: Skype for Business Online
PARAMVALUE: Guid
Parameter properties
| Type: | Guid |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Weekly
Applicable: Skype for Business Online
Type of Time window is weekly.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-WeeksOfMonth
Applicable: Skype for Business Online
Weeks of month. It can be multiple weeks separated by a comma. It must be defined when Type is Monthly.
Parameter properties
| Type: | TenantUpdateTimeWindowWeekOfMonth |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-WhatIf
Applicable: Skype for Business Online
PARAMVALUE: SwitchParameter
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | wi |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.