From c65ad49af6b9afa6d0f385498db24da8f9ed3a31 Mon Sep 17 00:00:00 2001
From: pavellatif <142821210+pavellatif@users.noreply.github.com>
Date: Wed, 15 Oct 2025 16:10:38 -0400
Subject: [PATCH] Update Get-CsPhoneNumberAssignment.md

adding new examples for Assignment Block
---
 .../Get-CsPhoneNumberAssignment.md            | 62 +++++++++++++++++++
 1 file changed, 62 insertions(+)

diff --git a/teams/teams-ps/MicrosoftTeams/Get-CsPhoneNumberAssignment.md b/teams/teams-ps/MicrosoftTeams/Get-CsPhoneNumberAssignment.md
index f76f4342ba..96ff1653c8 100644
--- a/teams/teams-ps/MicrosoftTeams/Get-CsPhoneNumberAssignment.md
+++ b/teams/teams-ps/MicrosoftTeams/Get-CsPhoneNumberAssignment.md
@@ -288,6 +288,68 @@ AssignmentBlockedUntil  :
 ```
 This example shows a way to get filtered results using tags. Tags are not case sensitive.
 
+### Example 14
+```powershell
+Get-CsPhoneNumberAssignment -TelephoneNumber +14025551234
+```
+```output
+TelephoneNumber         : +14025551234
+OperatorId              : 2b24d246-a9ee-428b-96bc-fb9d9a053c8d
+NumberType              : CallingPlan
+ActivationState         : Activated
+AssignedPstnTargetId    : 
+AssignmentCategory      : 
+Capability              : {UserAssignment}
+City                    : Omaha
+CivicAddressId          : 
+IsoCountryCode          : US
+IsoSubdivision          : Nebraska
+LocationId              : 
+LocationUpdateSupported : True
+NetworkSiteId           :
+PortInOrderStatus       :
+PstnAssignmentStatus    : Unassigned
+PstnPartnerId           : 7fc2f2eb-89aa-41d7-93de-73d015d22ff0
+PstnPartnerName         : Microsoft
+NumberSource            : Online
+ReverseNumberLookup		: {}
+Tag						: {}
+AssignmentBlockedState  : BlockedForever
+AssignmentBlockedUntil  :
+```
+This example displays information about the telephone number +1 (402) 555-1234 which has a permanent assignment block. This block prevents the number from being assigned to any other user. Admin can remove the block using [Remove-CsPhoneNumberAssignmentBlock](./remove-csphonenumberassignmentblock.md).
+
+### Example 15
+```powershell
+Get-CsPhoneNumberAssignment -TelephoneNumber +14025551234
+```
+```output
+TelephoneNumber         : +14025551234
+OperatorId              : 2b24d246-a9ee-428b-96bc-fb9d9a053c8d
+NumberType              : CallingPlan
+ActivationState         : Activated
+AssignedPstnTargetId    : 
+AssignmentCategory      : 
+Capability              : {UserAssignment}
+City                    : Omaha
+CivicAddressId          : 
+IsoCountryCode          : US
+IsoSubdivision          : Nebraska
+LocationId              : 
+LocationUpdateSupported : True
+NetworkSiteId           :
+PortInOrderStatus       :
+PstnAssignmentStatus    : Unassigned
+PstnPartnerId           : 7fc2f2eb-89aa-41d7-93de-73d015d22ff0
+PstnPartnerName         : Microsoft
+NumberSource            : Online
+ReverseNumberLookup		: {}
+Tag						: {}
+AssignmentBlockedState  : BlockedUntil
+AssignmentBlockedUntil  : 2025-10-11T21:30:00.0000000Z
+```
+This example displays information about the telephone number +1 (402) 555-1234 which has a temporary assignment block. This block prevents the number from being assigned to any other user. Once the period shown in AssignmentBlockUntil passes, the AssignmentBlock will be automatically removed and the number will become available to be assigned to any user. Admin can also remove the block manually using [Remove-CsPhoneNumberAssignmentBlock](./remove-csphonenumberassignmentblock.md).
+
 
 ## PARAMETERS