From f99ae03a253881b26571a01de72ef933c7b74731 Mon Sep 17 00:00:00 2001 From: Alekhya Jupudi <89069896+alekyaj@users.noreply.github.com> Date: Thu, 13 Feb 2025 11:56:44 +0530 Subject: [PATCH 01/10] Add IMAP/POP service behavior w.r.t Set-ServerComponentState The updates here are made as per task 9800612 --- .../exchange/Set-ServerComponentState.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/exchange/exchange-ps/exchange/Set-ServerComponentState.md b/exchange/exchange-ps/exchange/Set-ServerComponentState.md index 94f4d5e415..77be527b59 100644 --- a/exchange/exchange-ps/exchange/Set-ServerComponentState.md +++ b/exchange/exchange-ps/exchange/Set-ServerComponentState.md @@ -43,6 +43,23 @@ Set-ServerComponentState -Component UMCallRouter -Identity MailboxServer01 -Requ This example sets the Unified Messaging (UM) component state to Active, as requested by maintenance mode. +### Example 2 + +```powershell +Set-ServerComponentState Exch5 -Component ServerWideOffline -State Inactive -Requester Maintenance +``` + +This command is used o prepare the server for maintenance, such as installing security or cumulative updates. It changes the state of all server components to inactive during this process. + +After the maintenance is over, the state must be changed to Active using following command: + +```powershell +Set-ServerComponentState Exch5 -Component ServerWideOffline -State Active -Requester Maintenance +``` + +> [!NOTE] +> Microsoft Exchange IMAP4 & Microsoft Exchange POP3 services will stop if the related components `ImapProxy` and `PopProxy` are in Inactive state, this is by design behavior. The services should be started after the state of `ImapProxy` and `PopProxy` is changed to Active. + ## PARAMETERS ### -Identity From 83ca7046ed8a2cc0e963a0571b87a4479c14e8d7 Mon Sep 17 00:00:00 2001 From: Alekhya Jupudi <89069896+alekyaj@users.noreply.github.com> Date: Thu, 13 Feb 2025 14:48:42 +0530 Subject: [PATCH 02/10] Update Set-ServerComponentState.md --- exchange/exchange-ps/exchange/Set-ServerComponentState.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/exchange/exchange-ps/exchange/Set-ServerComponentState.md b/exchange/exchange-ps/exchange/Set-ServerComponentState.md index 77be527b59..6b7ece450c 100644 --- a/exchange/exchange-ps/exchange/Set-ServerComponentState.md +++ b/exchange/exchange-ps/exchange/Set-ServerComponentState.md @@ -49,7 +49,7 @@ This example sets the Unified Messaging (UM) component state to Active, as reque Set-ServerComponentState Exch5 -Component ServerWideOffline -State Inactive -Requester Maintenance ``` -This command is used o prepare the server for maintenance, such as installing security or cumulative updates. It changes the state of all server components to inactive during this process. +This command is used o prepare the server for maintenance, such as installing security or cumulative updates. It changes the state of all server components to Inactive during this process. After the maintenance is over, the state must be changed to Active using following command: @@ -58,7 +58,7 @@ Set-ServerComponentState Exch5 -Component ServerWideOffline -State Active -Reque ``` > [!NOTE] -> Microsoft Exchange IMAP4 & Microsoft Exchange POP3 services will stop if the related components `ImapProxy` and `PopProxy` are in Inactive state, this is by design behavior. The services should be started after the state of `ImapProxy` and `PopProxy` is changed to Active. +> By design behavior, Microsoft Exchange IMAP4 & Microsoft Exchange POP3 services will stop if the related components `ImapProxy` and `PopProxy` are in Inactive state. The services will be started after the state of `ImapProxy` and `PopProxy` is changed to Active. ## PARAMETERS From e1420b65fcfebe55a577c3e4ec3bdbf838d0cd56 Mon Sep 17 00:00:00 2001 From: Alekhya Jupudi <89069896+alekyaj@users.noreply.github.com> Date: Thu, 13 Feb 2025 14:53:38 +0530 Subject: [PATCH 03/10] Update Set-ServerComponentState.md --- exchange/exchange-ps/exchange/Set-ServerComponentState.md | 1 + 1 file changed, 1 insertion(+) diff --git a/exchange/exchange-ps/exchange/Set-ServerComponentState.md b/exchange/exchange-ps/exchange/Set-ServerComponentState.md index 6b7ece450c..f90981e476 100644 --- a/exchange/exchange-ps/exchange/Set-ServerComponentState.md +++ b/exchange/exchange-ps/exchange/Set-ServerComponentState.md @@ -7,6 +7,7 @@ schema: 2.0.0 author: chrisda ms.author: chrisda ms.reviewer: +description: Learn how to use the Set-ServerComponentState cmdlet to configure and update Microsoft Exchange components and endpoints on servers you specify. --- # Set-ServerComponentState From 59168ba1983236cc6e84f9be5707150b7dbf0892 Mon Sep 17 00:00:00 2001 From: Alekhya Jupudi <89069896+alekyaj@users.noreply.github.com> Date: Thu, 13 Feb 2025 14:57:42 +0530 Subject: [PATCH 04/10] Update Set-ServerComponentState.md --- exchange/exchange-ps/exchange/Set-ServerComponentState.md | 1 - 1 file changed, 1 deletion(-) diff --git a/exchange/exchange-ps/exchange/Set-ServerComponentState.md b/exchange/exchange-ps/exchange/Set-ServerComponentState.md index f90981e476..6b7ece450c 100644 --- a/exchange/exchange-ps/exchange/Set-ServerComponentState.md +++ b/exchange/exchange-ps/exchange/Set-ServerComponentState.md @@ -7,7 +7,6 @@ schema: 2.0.0 author: chrisda ms.author: chrisda ms.reviewer: -description: Learn how to use the Set-ServerComponentState cmdlet to configure and update Microsoft Exchange components and endpoints on servers you specify. --- # Set-ServerComponentState From c9528a0040cb84430eb624eb9f600d068dbaa95c Mon Sep 17 00:00:00 2001 From: Alekhya Jupudi <89069896+alekyaj@users.noreply.github.com> Date: Thu, 13 Feb 2025 15:02:53 +0530 Subject: [PATCH 05/10] Update Set-ServerComponentState.md --- exchange/exchange-ps/exchange/Set-ServerComponentState.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/exchange/exchange-ps/exchange/Set-ServerComponentState.md b/exchange/exchange-ps/exchange/Set-ServerComponentState.md index 6b7ece450c..6bf0e36a3b 100644 --- a/exchange/exchange-ps/exchange/Set-ServerComponentState.md +++ b/exchange/exchange-ps/exchange/Set-ServerComponentState.md @@ -49,7 +49,7 @@ This example sets the Unified Messaging (UM) component state to Active, as reque Set-ServerComponentState Exch5 -Component ServerWideOffline -State Inactive -Requester Maintenance ``` -This command is used o prepare the server for maintenance, such as installing security or cumulative updates. It changes the state of all server components to Inactive during this process. +This command is used to prepare the server for maintenance, such as installing a security update or cumulative update. This command changes the state of all server components to Inactive. After the maintenance is over, the state must be changed to Active using following command: From ad453df280564009eed8a976477f7d721551cae7 Mon Sep 17 00:00:00 2001 From: Alekhya Jupudi <89069896+alekyaj@users.noreply.github.com> Date: Thu, 13 Feb 2025 15:53:31 +0530 Subject: [PATCH 06/10] Update Set-ServerComponentState.md --- exchange/exchange-ps/exchange/Set-ServerComponentState.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/exchange/exchange-ps/exchange/Set-ServerComponentState.md b/exchange/exchange-ps/exchange/Set-ServerComponentState.md index 6bf0e36a3b..20d27ff159 100644 --- a/exchange/exchange-ps/exchange/Set-ServerComponentState.md +++ b/exchange/exchange-ps/exchange/Set-ServerComponentState.md @@ -49,16 +49,16 @@ This example sets the Unified Messaging (UM) component state to Active, as reque Set-ServerComponentState Exch5 -Component ServerWideOffline -State Inactive -Requester Maintenance ``` -This command is used to prepare the server for maintenance, such as installing a security update or cumulative update. This command changes the state of all server components to Inactive. +This command is used to prepare the server for maintenance, such as installing a security update or cumulative update. This command changes the state of all server components to inactive. -After the maintenance is over, the state must be changed to Active using following command: +After the maintenance is over, the state must be changed to active using following command: ```powershell Set-ServerComponentState Exch5 -Component ServerWideOffline -State Active -Requester Maintenance ``` > [!NOTE] -> By design behavior, Microsoft Exchange IMAP4 & Microsoft Exchange POP3 services will stop if the related components `ImapProxy` and `PopProxy` are in Inactive state. The services will be started after the state of `ImapProxy` and `PopProxy` is changed to Active. +> By design behavior, Microsoft Exchange IMAP4 & Microsoft Exchange POP3 services will stop if the related components `ImapProxy` and `PopProxy` are in inactive state. The services will be started after the state of `ImapProxy` and `PopProxy` is changed to active. ## PARAMETERS From 6957ee4c6a69512b97e30920d47ed105d42b8140 Mon Sep 17 00:00:00 2001 From: Chris Davis Date: Thu, 13 Feb 2025 08:58:08 -0800 Subject: [PATCH 07/10] Reorder parameters in Set-ServerComponentState examples --- .../exchange/Set-ServerComponentState.md | 18 ++++++++---------- 1 file changed, 8 insertions(+), 10 deletions(-) diff --git a/exchange/exchange-ps/exchange/Set-ServerComponentState.md b/exchange/exchange-ps/exchange/Set-ServerComponentState.md index 20d27ff159..c9d3a9aec3 100644 --- a/exchange/exchange-ps/exchange/Set-ServerComponentState.md +++ b/exchange/exchange-ps/exchange/Set-ServerComponentState.md @@ -38,27 +38,25 @@ You need to be assigned permissions before you can run this cmdlet. Although thi ### Example 1 ```powershell -Set-ServerComponentState -Component UMCallRouter -Identity MailboxServer01 -Requester Maintenance -State Active +Set-ServerComponentState -Identity MailboxServer01 -Component UMCallRouter -Requester Maintenance -State Active ``` This example sets the Unified Messaging (UM) component state to Active, as requested by maintenance mode. ### Example 2 - ```powershell -Set-ServerComponentState Exch5 -Component ServerWideOffline -State Inactive -Requester Maintenance +Set-ServerComponentState -Identity Exch5 -Component ServerWideOffline -State Inactive -Requester Maintenance + +Set-ServerComponentState -Identity Exch5 -Component ServerWideOffline -State Active -Requester Maintenance ``` -This command is used to prepare the server for maintenance, such as installing a security update or cumulative update. This command changes the state of all server components to inactive. +This example prepares the server for maintenance, such as installing a Security Update or Cumulative Update. -After the maintenance is over, the state must be changed to active using following command: +The first command changes the state of all server components to Inactive. -```powershell -Set-ServerComponentState Exch5 -Component ServerWideOffline -State Active -Requester Maintenance -``` +The second command changes the state to Active after the maintenance is over (required). -> [!NOTE] -> By design behavior, Microsoft Exchange IMAP4 & Microsoft Exchange POP3 services will stop if the related components `ImapProxy` and `PopProxy` are in inactive state. The services will be started after the state of `ImapProxy` and `PopProxy` is changed to active. +**Note**: By design, the Microsoft Exchange IMAP4 and Microsoft Exchange POP3 services stop if the related `ImapProxy` and `PopProxy` components are in the Inactive state. The services start after the `ImapProxy` and `PopProxy` components are changed to the Active state. ## PARAMETERS From b94712d85c6e060dc64755836088423f154328ed Mon Sep 17 00:00:00 2001 From: Alekhya Jupudi <89069896+alekyaj@users.noreply.github.com> Date: Mon, 17 Feb 2025 09:26:49 +0530 Subject: [PATCH 08/10] Update Set-ServerComponentState.md --- exchange/exchange-ps/exchange/Set-ServerComponentState.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/exchange/exchange-ps/exchange/Set-ServerComponentState.md b/exchange/exchange-ps/exchange/Set-ServerComponentState.md index c9d3a9aec3..1b887d2954 100644 --- a/exchange/exchange-ps/exchange/Set-ServerComponentState.md +++ b/exchange/exchange-ps/exchange/Set-ServerComponentState.md @@ -56,7 +56,7 @@ The first command changes the state of all server components to Inactive. The second command changes the state to Active after the maintenance is over (required). -**Note**: By design, the Microsoft Exchange IMAP4 and Microsoft Exchange POP3 services stop if the related `ImapProxy` and `PopProxy` components are in the Inactive state. The services start after the `ImapProxy` and `PopProxy` components are changed to the Active state. +**Note**: By design, the Microsoft Exchange IMAP4 and Microsoft Exchange POP3 services stop if the related `ImapProxy` and `PopProxy` components are in the Inactive state. The services may need to be manually started after the related `ImapProxy` and `PopProxy` components are changed to the Active state. ## PARAMETERS From ad169193730c6a22a76c74f38965a296ad6d5f76 Mon Sep 17 00:00:00 2001 From: Padma Jayaraman Date: Mon, 17 Feb 2025 16:47:32 +0530 Subject: [PATCH 09/10] Fixed Note style --- exchange/exchange-ps/exchange/Set-ServerComponentState.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/exchange/exchange-ps/exchange/Set-ServerComponentState.md b/exchange/exchange-ps/exchange/Set-ServerComponentState.md index 1b887d2954..f7f49519f6 100644 --- a/exchange/exchange-ps/exchange/Set-ServerComponentState.md +++ b/exchange/exchange-ps/exchange/Set-ServerComponentState.md @@ -56,7 +56,8 @@ The first command changes the state of all server components to Inactive. The second command changes the state to Active after the maintenance is over (required). -**Note**: By design, the Microsoft Exchange IMAP4 and Microsoft Exchange POP3 services stop if the related `ImapProxy` and `PopProxy` components are in the Inactive state. The services may need to be manually started after the related `ImapProxy` and `PopProxy` components are changed to the Active state. +> [!NOTE] +> By design, the Microsoft Exchange IMAP4 and Microsoft Exchange POP3 services stop if the related `ImapProxy` and `PopProxy` components are in the Inactive state. The services may need to be manually started after the related `ImapProxy` and `PopProxy` components are changed to the Active state. ## PARAMETERS From 6f78e3da546322d33fd8eca021cb9251129a1572 Mon Sep 17 00:00:00 2001 From: Padma Jayaraman Date: Mon, 17 Feb 2025 17:03:06 +0530 Subject: [PATCH 10/10] Reverted the change --- exchange/exchange-ps/exchange/Set-ServerComponentState.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/exchange/exchange-ps/exchange/Set-ServerComponentState.md b/exchange/exchange-ps/exchange/Set-ServerComponentState.md index f7f49519f6..1b887d2954 100644 --- a/exchange/exchange-ps/exchange/Set-ServerComponentState.md +++ b/exchange/exchange-ps/exchange/Set-ServerComponentState.md @@ -56,8 +56,7 @@ The first command changes the state of all server components to Inactive. The second command changes the state to Active after the maintenance is over (required). -> [!NOTE] -> By design, the Microsoft Exchange IMAP4 and Microsoft Exchange POP3 services stop if the related `ImapProxy` and `PopProxy` components are in the Inactive state. The services may need to be manually started after the related `ImapProxy` and `PopProxy` components are changed to the Active state. +**Note**: By design, the Microsoft Exchange IMAP4 and Microsoft Exchange POP3 services stop if the related `ImapProxy` and `PopProxy` components are in the Inactive state. The services may need to be manually started after the related `ImapProxy` and `PopProxy` components are changed to the Active state. ## PARAMETERS