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:00This 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:00This 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:00This example creates a new tenant update time window in the tenant in Weekly type.
-------------------------- Example 4 --------------------------
New-CsTenantUpdateTimeWindow -Identity Night -DailyThis 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 |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Skype for Business Online |
-InMemory
PARAMVALUE: SwitchParameter
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Skype for Business Online |
-Tenant
PARAMVALUE: Guid
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Skype for Business Online |
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for