Skip to content

Update Get-CsOnlineUser.md - Removing redundant information #9104

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Mar 21, 2022
Merged

Update Get-CsOnlineUser.md - Removing redundant information #9104

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
31db933
Update Get-CsOnlineUser.md
isrumnon Mar 15, 2022
85e3f85
Update Get-CsOnlineUser.md
isrumnon Mar 21, 2022
66ca47c
Merge branch 'main' into patch-15
isrumnon Mar 21, 2022
59bb986
Update Get-CsOnlineUser.md
isrumnon Mar 21, 2022
3d1580a
Update Get-CsOnlineUser.md
isrumnon Mar 21, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
198 changes: 181 additions & 17 deletions skype/skype-ps/skype/Get-CsOnlineUser.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -199,6 +199,9 @@ In the Teams PowerShell Module version 3.0.0 or later, filtering functionality i
- givenName
- Identity
- lineUri
- userPrincipalName
- CallingLineIdentity
- ExternalAccessPolicy
- OnlineAudioConferencingRoutingPolicy
- OnlineDialOutPolicy
- OnlineVoicemailPolicy
Expand Down Expand Up @@ -287,20 +290,28 @@ In the Teams PowerShell Module version 3.0.0 or later, filtering functionality i
- TeamsVdiPolicy
- TeamsVerticalPackagePolicy
- TeamsVideoInteropServicePolicy
- TeamsEducationAssignmentsAppPolicy
- TeamsComplianceRecordingPolicy
- TeamsWorkLoadPolicy
- VoiceRoutingPolicy
- AssignedPlan
- EnterpriseVoiceEnabled
- Identity
- department
- UserDirSyncEnabled
- TenantDialPlan
- Title
- UsageLocation
- UserDirSyncEnabled
- userPrincipalName

In the Teams PowerShell Module version 3.0.0 or later, the following attributes have been renamed:

- ObjectId is now Identity.
- FirstName is now GivenName.
- DirSyncEnabled is now UserDirSyncEnabled.
- MCOValidationError is now UserValidationErrors.
- Enabled is now IsSipEnabled.
- TeamsBranchSurvivabilityPolicy is now TeamsSurvivableBranchAppliancePolicy.
*Attributes that have changed in meaning/format*:

**OnPremLineURI**: This attribute previously used to refer to both:

1. LineURI set via OnPrem AD.
2. Direct Routing numbers assigned to users via Set-CsUser.

In the Teams PowerShell Module version 3.0.0 or later, the **OnPremLineURI** attribute refers only to the LineURI that's set via OnPrem AD. Previously, **OnPremLineURI** also referred to Direct Routing numbers that were assigned to users via the Set-CsUser cmdlet. Now, Direct Routing numbers are available in the **LineURI** attribute. You can distinguish Direct Routing Numbers from Calling Plan Numbers by looking at the **FeatureTypes** attribute.

Expand All @@ -310,16 +321,22 @@ In the Teams PowerShell Module version 3.0.0 or later, the format of the Assigne
- All users with an AssignedPlan that starts with MCO: `-Filter "AssignedPlan -eq 'MCO*'"`
- All users with an AssignedPlan that contains MCO: `-Filter "AssignedPlan -eq '*MCO*'"`

In the Teams PowerShell Module version 3.0.0 or later, the output format of Policies has now changed from String to JSON type UserPolicyDefinition.
**Policy Attributes:**

- PolicyProperty comparison works only when "Authority" is provided in the value. For ex: TeamsMessagingPolicy -eq "<Authority>:<Value>"
"Authority" can contain any of these two values: Host or Tenant for a policy type (PreCanned/Default configurations provided by feature team are refered to as Host configurations while Admin-created configurations are considered Tenant configurations)

- In the Teams PowerShell Module version 3.0.0 or later, the output format of Policies has now changed from String to JSON type UserPolicyDefinition.


*Dropped Filter operators*:

The following filter syntaxes are not supported in Teams PowerShell Module 3.0.0 and above:

In the Teams PowerShell Module version 3.0.0 or later, the following PowerShell logical operators are no longer supported:
- not, -lt, -gt: These operators have been dropped
- ge, -ne: These operators are not supported with policy properties
- like: This operator is supported only with wildcard character in the end (e.g., "like <value>*")

- Not (`-not`)
- Like (`-like`)
- Less than (`-lt`)
- Less than or equal to (`-le`)
- Greater than (`-gt`)
- Greater than or equal to (`-ge`)

```yaml
Type: String
Expand Down Expand Up @@ -460,9 +477,156 @@ Accept wildcard characters: False
### CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/?LinkID=113216).

## INPUTS

## OUTPUTS

### Note:

The following updates are applicable for TeamsOnly customers using Microsoft Teams PowerShell version 3.0.0 and above.

_New user attributes_

FeatureTypes – Array of unique strings specifying what features are enabled for a user. This attribute is an alternatitive to several attributes that have been dropped as outlined in the next section.
Some of the commonly used FeatureTypes include:
- Teams
- AudioConferencing
- PhoneSystem
- CallingPlan

_Dropped attributes_

The following attributes are no longer relevant to Teams and have been dropped from the output:

- AcpInfo
- AdminDescription
- ArchivingPolicy
- AudioVideoDisabled
- BaseSimpleUrl
- BroadcastMeetingPolicy
- CallViaWorkPolicy
- ClientPolicy
- ClientUpdateOverridePolicy
- ClientVersionPolicy
- CloudMeetingOpsPolicy
- CloudMeetingPolicy
- CloudVideoInteropPolicy
- ContactOptionFlags
- CountryOrRegionDisplayName
- Description
- DistinguishedName
- EnabledForRichPresence
- ExchangeArchivingPolicy
- ExchUserHoldPolicies
- ExperiencePolicy
- ExternalUserCommunicationPolicy
- ExUmEnabled
- Guid
- HomeServer
- HostedVoicemailPolicy
- IPPBXSoftPhoneRoutingEnabled
- IPPhone
- IPPhonePolicy
- IsByPassValidation
- IsValid
- LegalInterceptPolicy
- LicenseRemovalTimestamp
- LineServerURI
- Manager
- MNCReady
- Name
- NonPrimaryResource
- ObjectCategory
- ObjectClass
- ObjectState
- OnPremHideFromAddressLists
- OriginalPreferredDataLocation
- OriginatingServer
- OriginatorSid
- OverridePreferredDataLocation
- PendingDeletion
- PrivateLine
- ProvisioningCounter
- ProvisioningStamp
- PublishingCounter
- PublishingStamp
- Puid
- RemoteCallControlTelephonyEnabled
- RemoteMachine
- SamAccountName
- ServiceInfo
- StsRefreshTokensValidFrom
- SubProvisioningCounter
- SubProvisioningStamp
- SubProvisionLineType
- SyncingCounter
- TargetRegistrarPool
- TargetServerIfMoving
- TeamsInteropPolicy
- ThumbnailPhoto
- UpgradeRetryCounter
- UserAccountControl
- UserProvisionType
- UserRoutingGroupId
- VoicePolicy - Alternative is the CallingPlan and PhoneSystem string in FeatureTypes
- XForestMovePolicy
- AddressBookPolicy
- GraphPolicy
- PinPolicy
- PreferredDataLocationOverwritePolicy
- PresencePolicy
- SmsServicePolicy
- TeamsVoiceRoute
- ThirdPartyVideoSystemPolicy
- UserServicesPolicy
- ConferencingPolicy
- Id
- MobilityPolicy
- OnlineDialinConferencingPolicy - Alternative is the AudioConferencing string in FeatureTypes
- Sid
- TeamsWorkLoadPolicy
- VoiceRoutingPolicy
- ClientUpdatePolicy
- HomePhone
- HostedVoiceMail
- MobilePhone
- OtherTelephone
- StreetAddress
- WebPage
- AssignedLicenses
- OnPremisesUserPrincipalName
- HostedVoiceMail
- LicenseAssignmentStates
- OnPremDomainName
- OnPremSecurityIdentifier
- OnPremSamAccountName
- CallerIdPolicy
- Fax
- LastName
- Office
- Phone
- WindowsEmailAddress

*Attributes renamed*

- ObjectId renamed to Identity
- FirstName renamed to GivenName
- DirSyncEnabled renamed to UserDirSyncEnabled
- MCOValidationErrors renamed to UserValidationErrors
- Enabled renamed to IsSipEnabled
- TeamsBranchSurvivabilityPolicy renamed to TeamsSurvivableBranchAppliancePolicy

*Attributes that have changed in meaning/format*

**OnPremLineURI**: This attribute previously used to refer to both:
1. LineURI set via OnPrem AD.
2. Direct Routing numbers assigned to users via Set-CsUser.

In Teams PowerShell Modules 3.0.0 and above OnPremLineURI will only refer to the LineURI set via OnPrem AD. Direct Routing numbers will be available from the LineURI field. Direct Routing Numbers can be distinguished from Calling Plan Numbers by looking at the FeatureTypes attribute.

**- The output format of AssignedPlan and ProvisionedPlan have now changed from XML to JSON array.**

**- The output format of Policies has now changed from String to JSON type UserPolicyDefinition.**

## INPUTS

## NOTES

Expand Down