Updates to new-team cmdlet

Author: islubin

teams/teams-ps/teams/New-Team.md

@@ -1,45 +1,43 @@
 ---
 external help file: Microsoft.TeamsCmdlets.PowerShell.Custom.dll-Help.xml
 Module Name: MicrosoftTeams
-applicable: Microsoft Teams
-title: New-Team
-online version: 
+online version:
 schema: 2.0.0
 ---
 
 # New-Team
 
 ## SYNOPSIS
-Note: This cmdlet is currently in Beta.
+This cmdlet lets you provision a new Team for use in Microsoft Teams and will create an O365 Unified Group to back the team.  Groups created through teams cmdlets, APIs, or clients will not show up in Outlook by default.  If you want these groups to appear in Outlook clients, you can use the Set-UnifiedGroup (https://docs.microsoft.com/en-us/powershell/module/exchange/users-and-groups/set-unifiedgroup?view=exchange-ps) cmdlet in the Exchange Powershell Module to set the parameter HiddenFromExchangeClients to $false. 
 
-Creates a new team.
-The new team will be backed by a new unified group.
+Note: This cmdlet is currently in Beta and functionality may change.
 
 ## SYNTAX
 
 ```
-New-Team -DisplayName <String> [-Description <String>] [-Alias <String>] [-Classification <String>]
- [-AccessType <String>] [-AddCreatorAsMember <Boolean>]
+New-Team [-Group <String>] [-DisplayName <String>] [-Description <String>] [-Alias <String>]
+ [-Classification <String>] [-AccessType <String>] [-AddCreatorAsMember <Boolean>] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
 Creates a new team with user specified settings, and returns a Group object with a GroupID property.
 
 ## EXAMPLES
 
-### --------------------------  Example 1  --------------------------
+### Example 1
 ```
 New-Team -DisplayName "Tech Reads"
 ```
 
-### --------------------------  Example 2  --------------------------
+### Example 2
 ```
 New-Team -DisplayName "Tech Reads" -Description "Team to post technical articles and blogs" -AccessType Public
 ```
-### --------------------------  Example 3  --------------------------
+
+### Example 3
 ```
 Connect-MicrosoftTeams -AccountId [email protected]
-$group = New-Team -alias “TestTeam” -displayname “Test Teams” -AccessType “private”
+$group = New-Team -alias "TestTeam" -displayname "Test Teams" -AccessType "private"
 Add-TeamUser -GroupId $group.GroupId -User "[email protected]"
 Add-TeamUser -GroupId $group.GroupId -User "[email protected]"
 Add-TeamUser -GroupId $group.GroupId -User "[email protected]"
@@ -49,22 +47,6 @@ New-TeamChannel -GroupId $group.GroupId -DisplayName "Contracts"
 Set-TeamFunSettings -GroupId $group.GroupId -AllowCustomMemes true
 ```
 
-Create a team with some members and channels.
-
-### --------------------------  Example 4  --------------------------
-```
-Get-MsolGroup -SearchString "TestyTest" | Where-Object DisplayName -eq TestyTest | foreach-object -process { 
-    $name = "TestConvert" + $_.DisplayName 
-    $group = New-Team -displayname $name 
-    Get-MsolGroupMember -GroupObjectId $_.ObjectId | foreach-object -process { 
-        Add-TeamUser -GroupId $group.GroupId -User $_.EmailAddress 
-    } 
-} 
-```
-
-Iterate over all Groups and create corresponding Teams.
-
-
 ## PARAMETERS
 
 ### -AccessType
@@ -77,7 +59,6 @@ Default is "Private".
 Type: String
 Parameter Sets: (All)
 Aliases:
-Applicable: Microsoft Teams
 
 Required: False
 Position: Named
@@ -87,14 +68,13 @@ Accept wildcard characters: False
 ```
 
 ### -AddCreatorAsMember
-This setting lets you decide if you will be added as a member of the team. 
-The default is true.
+This setting lets you decide if you will be added as a member of the group. 
+Because you are automatically an owner of the group, you will always be added as a member to the team.
 
 ```yaml
 Type: Boolean
 Parameter Sets: (All)
 Aliases:
-Applicable: Microsoft Teams
 
 Required: False
 Position: Named
@@ -111,7 +91,6 @@ Team Alias Characters Limit - 64
 Type: String
 Parameter Sets: (All)
 Aliases:
-Applicable: Microsoft Teams
 
 Required: False
 Position: Named
@@ -127,7 +106,6 @@ Team classification
 Type: String
 Parameter Sets: (All)
 Aliases:
-Applicable: Microsoft Teams
 
 Required: False
 Position: Named
@@ -144,7 +122,6 @@ Team Description Characters Limit - 1024.
 Type: String
 Parameter Sets: (All)
 Aliases:
-Applicable: Microsoft Teams
 
 Required: False
 Position: Named
@@ -161,15 +138,34 @@ Team Name Characters Limit - 256.
 Type: String
 Parameter Sets: (All)
 Aliases:
-Applicable: Microsoft Teams
 
-Required: True
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: True (ByPropertyName)
+Accept wildcard characters: False
+```
+
+### -Group
+Use this parameter to specify the groupid of a group you would like to convert to a team.
+If you use this parameter, do not specify other parameters.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+Aliases:
+
+Required: False
 Position: Named
 Default value: None
 Accept pipeline input: True (ByPropertyName)
 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 (http://go.microsoft.com/fwlink/?LinkID=113216).
+
 ## INPUTS
 
 ## OUTPUTS
@@ -179,7 +175,3 @@ Accept wildcard characters: False
 ## NOTES
 
 ## RELATED LINKS
-
-[Get-Team](Get-Team.md)
-
-[Set-Team](Set-Team.md)