You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Feb 20, 2022. It is now read-only.
Copy file name to clipboardExpand all lines: skype/skype-ps/skype/Move-CsUser.md
+54-57Lines changed: 54 additions & 57 deletions
Original file line number
Diff line number
Diff line change
@@ -14,84 +14,80 @@ ms.reviewer:
14
14
15
15
Moves one or more user accounts enabled for Skype for Business Server to a new Registrar pool, or to Office 365 (either to Teams or Skype for Business Online).
The Move-CsUser cmdlet enables you to move a user account enabled for Skype for Business in the following scenarios:
32
-
- from an on-premises Skype for Business deployment to Teams-only in Office 365 (or the reverse)
33
-
- from an on-premises Skype for Business deployment to Skype for Business Online in Office 365 (or the reverse)
34
-
- from one registrar pool to another, in an on-premises Skype for Business Server deployment.
35
-
The Move-CsUser cmdlet affects only the user's Skype for Business Server account location; it does not move the user's Active Directory account to a new organizational unit (OU) or other new location.
28
+
29
+
- from an on-premises Skype for Business deployment to Teams-only in Office 365 (or the reverse)
30
+
- from an on-premises Skype for Business deployment to Skype for Business Online in Office 365 (or the reverse)
31
+
- from one registrar pool to another, in an on-premises Skype for Business Server deployment.
32
+
33
+
The Move-CsUser cmdlet affects only the user's Skype for Business Server account location; it does not move the user's Active Directory account to a new organizational unit (OU) or other new location.
36
34
37
35
When moving a user to or from Office 365 (either Skype for Business Online or Teams):
38
-
- Skype for Business hybrid must be configured. For more information, see [Deploy hybrid connectivity between Skype for Business Server and Skype for Business Online](https://docs.microsoft.com/SkypeForBusiness/skype-for-business-hybrid-solutions/deploy-hybrid-connectivity/deploy-hybrid-connectivity).
39
-
- To move a user to Office 365, specify the ProxyFqdn of the hosting provider as the Target. In most cases, this is "sipfed.online.lync.com" but in specialized environments there will be variants of this address. For more details, see [Move users between on-premises and cloud](https://docs.microsoft.com/skypeforbusiness/hybrid/move-users-between-on-premises-and-cloud).
40
-
- When migrating from on-premises to the cloud, meetings are migrated from Skype for Business Server to online. If the `MoveToTeams` switch is specified, the meetings will be migrated to Teams meetings. Otherwise, meeetings are migrated to Skype for Business Online. Teams-only users can still join meetings hosted in Skype for Business. For details see [Using the Meeting Migration Service (MMS)](https://docs.microsoft.com/skypeforbusiness/audio-conferencing-in-office-365/setting-up-the-meeting-migration-service-mms).
41
-
- Moving a user to Teams is achieved by specifying the MoveToTeams switch. This performs the same operations as a move to Skype for Business Online (without the specifying -MoveToTeams) and also performs the following actions:
42
-
- TeamsUpgradePolicy with Mode=TeamsOnly is assigned to the online user account.
43
-
- Meeting migration is triggered to move meetings to Teams instead of Skype for Business Online. This functionality is currently available to TAP customers only. For customers not in TAP, meetings are always migrated to Skype for Business Online.
44
-
- Contacts are moved in all cases, unless -force is specified.
45
36
46
-
47
-
> [!NOTE]
48
-
> The MoveToTeams switch is only available on Skype for Business Server 2019 and CU8 for Skype for Business Server 2015. Organizations using other versions of Skype for Business Server must first move the user to Skype for Business Online, and then apply TeamsUpgradePolicy.
37
+
- Skype for Business hybrid must be configured. For more information, see [Deploy hybrid connectivity between Skype for Business Server and Skype for Business Online](https://docs.microsoft.com/en-us/SkypeForBusiness/skype-for-business-hybrid-solutions/deploy-hybrid-connectivity/deploy-hybrid-connectivity).
38
+
- To move a user to Office 365, specify the ProxyFqdn of the hosting provider as the Target. In most cases, this is "sipfed.online.lync.com" but in specialized environments there will be variants of this address. For more details, see [Move users between on-premises and cloud](https://docs.microsoft.com/en-us/skypeforbusiness/hybrid/move-users-between-on-premises-and-cloud).
39
+
- When migrating from on-premises to the cloud, meetings are migrated from Skype for Business Server to online. If the `MoveToTeams` switch is specified, the meetings will be migrated to Teams meetings. Otherwise, meetings are migrated to Skype for Business Online. Teams-only users can still join meetings hosted in Skype for Business. For details see [Using the Meeting Migration Service (MMS)](https://docs.microsoft.com/en-us/skypeforbusiness/audio-conferencing-in-office-365/setting-up-the-meeting-migration-service-mms).
40
+
- Moving a user to Teams is achieved by specifying the MoveToTeams switch. This performs the same operations as a move to Skype for Business Online (without the specifying -MoveToTeams) and also performs the following actions:
49
41
42
+
- TeamsUpgradePolicy with Mode=TeamsOnly is assigned to the online user account.
43
+
- Meeting migration is triggered to move meetings to Teams instead of Skype for Business Online. This functionality is currently available to TAP customers only. For customers not in TAP, meetings are always migrated to Skype for Business Online.
50
44
45
+
- Contacts are moved in all cases, unless -force is specified.
51
46
47
+
> [!NOTE]
48
+
> The MoveToTeams switch is only available on Skype for Business Server 2019 and CU8 for Skype for Business Server 2015. Organizations using other versions of Skype for Business Server must first move the user to Skype for Business Online, and then apply TeamsUpgradePolicy.
52
49
53
50
## EXAMPLES
54
51
55
-
### ------- EXAMPLE 1: Move a user to Teams-----------------------
56
-
```
52
+
### ------- EXAMPLE 1: Move a user to Teams-----------------------
In Example 1, the Move-CsUser cmdlet is used to move the user account with sip address [email protected] to Teams. This user will now be a Teams only user. If -Credential parameter is not specified, the admin will be prompted for credentials.
63
60
64
-
### ------- EXAMPLE 2: Move a user to Skype for Business Online ----
65
-
```
61
+
### ------- EXAMPLE 2: Move a user to Skype for Business Online ----
In Example 2, the Move-CsUser cmdlet is used to move the user account with sip address [email protected] to Skype for Business Online. This is the same cmdlet usage as example 1, except the MoveToTeams switch is not specified.
68
+
In Example 2, the Move-CsUser cmdlet is used to move the user account with sip address [email protected] to Skype for Business Online. This is the same cmdlet usage as example 1, except the MoveToTeams switch is not specified.
71
69
72
-
### -------- EXAMPLE 3: Move a user to another on-premises pool-------
73
-
```
70
+
### -------- EXAMPLE 3: Move a user to another on-premises pool-------
In Example 3, the Move-CsUser cmdlet is used to move the user account with the Identity Pilar Ackerman to the Registrar pool atl-cs-001.litwareinc.com.
79
77
78
+
### --------- EXAMPLE 4: Move multiple users ---------------------------
80
79
81
-
### --------- EXAMPLE 4: Move multiple users ---------------------------
In Example 4, all the user accounts in the Finance organizational unit (OU) are moved to the Registrar pool atl-cs-001.litwareinc.com.
88
85
To carry out this task, the command first uses the Get-CsUser cmdlet and the OU parameter to retrieve a collection of all the user accounts in the Finance OU. After the data has been retrieved, the information is piped to the Move-CsUser cmdlet, which moves each account in the collection to the Registrar pool atl-cs-001.litwareinc.com.
89
86
90
-
91
-
92
87
## PARAMETERS
93
88
94
89
### -Identity
90
+
95
91
Indicates the Identity of the user account to be moved.
96
92
User Identities can be specified using one of four formats: 1) the user's SIP address; 2) the user's user principal name (UPN); 3) the user's domain name and logon name, in the form domain\logon (for example, litwareinc\kenmyer); and, 4) the user's Active Directory display name (for example, Ken Myer).
97
93
User Identities can also be referenced by using the user's Active Directory distinguished name.
@@ -102,7 +98,7 @@ For example, the Identity "* Smith" returns all the users with who have a displa
102
98
```yaml
103
99
Type: UserIdParameter
104
100
Parameter Sets: (All), Identity
105
-
Aliases:
101
+
Aliases:
106
102
Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
107
103
108
104
Required: True
@@ -118,11 +114,10 @@ If moving to an on-premises pool (either from another pool or from Office 365),
118
114
119
115
If moving to Office 365, this must be set to the ProxyFqdn value of the hosting provider. In most cases this is sipfed.online.lync.com. The value of the ProxyFqdn can be obtained using Get-CsHostingProvider
120
116
121
-
122
117
```yaml
123
118
Type: Fqdn
124
119
Parameter Sets: (All)
125
-
Aliases:
120
+
Aliases:
126
121
Applicable: Lync Server 2010, Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
127
122
128
123
Required: True
@@ -132,9 +127,8 @@ Accept pipeline input: False
132
127
Accept wildcard characters: False
133
128
```
134
129
135
-
136
-
137
130
### -MoveToTeams
131
+
138
132
If specified, the user will be moved to Office 365 as a Teams-only user. This will ensure incoming chats and calls land in the user's Teams client. This parameter is only available with Skype for Business Server 2019 and CU8 for Skype for Business Server 2015.
Enables you to run the Move-CsUser cmdlet under alternate credentials, which is typically required when moving to Office 365. To use the Credential parameter you must first create a PSCredential object using the Get-Credential cmdlet. For details, see the Get-Credential cmdlet help topic.
157
149
158
-
159
150
```yaml
160
151
Type: PSCredential
161
152
Parameter Sets: (All)
162
-
Aliases:
153
+
Aliases:
163
154
Applicable: Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
The hosted migration service is the service in Office 365 that performs user moves. By default, there is no need to specify a value for this parameter, as long as the hosting provider has its AutoDiscover URL properly configured and you are using an admin account the ends in .onmicrosoft.com. If you are using a user account from on-premises that synchronized to the cloud, you must specify this parameter. See [Required administrative credentials](https://docs.microsoft.com/skypeforbusiness/hybrid/move-users-between-on-premises-and-cloud#required-administrative-credentials).
175
166
176
-
177
-
178
167
```yaml
179
168
Type: String
180
169
Parameter Sets: (All)
181
-
Aliases:
170
+
Aliases:
182
171
Applicable: Lync Server 2013, Skype for Business Server 2015, Skype for Business Server 2019
By default, if the on-premise user is configured for dial in conferencing, moving the user to Office 365 will provision the user for Audio Conferencing, for an additional license is required. If you want to move such a user to Office 365 but do not want to configure them for Audio Conferencing, specify this switch to by-pass the license check. This parameter is only available with Skype for Business Server 2019 and CU8 for Skype for Business Server 2015.
193
183
194
184
```yaml
@@ -202,8 +192,10 @@ Default value: None
202
192
Accept pipeline input: False
203
193
Accept wildcard characters: False
204
194
```
195
+
205
196
### -BypassEnterpriseVoiceCheck
206
-
By default, if the on-premise user is configured for Enteprise Voice, moving the user to Office 365 will provision the user for Microsoft Phone System, for an additional license is required. If you want to move such a user to Office 365 but do not want to configure them for Phone System, specify this switch to by-pass the license check. This parameter is only available with Skype for Business Server 2019 and CU8 for Skype for Business Server 2015.
197
+
198
+
By default, if the on-premise user is configured for Enterprise Voice, moving the user to Office 365 will provision the user for Microsoft Phone System, for an additional license is required. If you want to move such a user to Office 365 but do not want to configure them for Phone System, specify this switch to by-pass the license check. This parameter is only available with Skype for Business Server 2019 and CU8 for Skype for Business Server 2015.
This is an optional parameter that if, specified, pre-populates the username of the tenant admin when moving users to or from Office 365. This can be useful for scenarios involving smart card authentication or 2 factor auth. This parameter is only available with Skype for Business Server 2019 and CU8 for Skype for Business Server 2015.
222
213
214
+
This is an optional parameter that if, specified, pre-populates the username of the tenant admin when moving users to or from Office 365. This can be useful for scenarios involving smart card authentication or 2 factor auth. This parameter is only available with Skype for Business Server 2019 and CU8 for Skype for Business Server 2015.
This cmdlet supports the common parameters: `-Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).`
330
325
331
326
## INPUTS
332
327
328
+
### String
333
329
334
-
###
335
-
String or Microsoft.Rtc.Management.ADConnect.Schema.ADUser object.
336
330
The Move-CsUser cmdlet accepts a pipelined string value representing the Identity of a user account that has been enabled for Skype for Business Server.
The cmdlet also accepts pipelined instances of the Active Directory user object.
338
335
339
336
## OUTPUTS
340
337
341
-
###
338
+
### None
339
+
342
340
The Move-CsUser cmdlet does not return a value or object.
343
341
Instead, the cmdlet modifies instances of the Microsoft.Rtc.Management.ADConnect.Schema.ADUser object.
344
342
@@ -353,4 +351,3 @@ Instead, the cmdlet modifies instances of the Microsoft.Rtc.Management.ADConnect
353
351
[Migration and interoperability guidance for organizations using Teams together with Skype for Business](https://docs.microsoft.com/MicrosoftTeams/migration-interop-guidance-for-teams-with-skype)
354
352
355
353
[Using the Meeting Migration Service (MMS)](https://docs.microsoft.com/skypeforbusiness/audio-conferencing-in-office-365/setting-up-the-meeting-migration-service-mms)
0 commit comments