Updating docs for our Teams PowerShell 1.0 release.

Author: islubin

teams/teams-ps/teams/Add-TeamUser.md

@@ -1,38 +1,31 @@
 ---
 external help file: Microsoft.TeamsCmdlets.PowerShell.Custom.dll-Help.xml
 Module Name: MicrosoftTeams
-applicable: Microsoft Teams
-title: Add-TeamUser
-online version: 
+online version:
 schema: 2.0.0
-author: kenwith
-ms.author: kenwith
-ms.reviewer:
 ---
 
 # Add-TeamUser
 
 ## SYNOPSIS
-Note: This cmdlet is currently in Beta.
-
-Adds an owner or member to the team, and to the unified group which backs the team. 
+Adds an owner or member to the team,  and to the unified group which backs the team.
 
 Note: the command will return immediately, but the Teams application will not reflect the update immediately. 
 The Teams application may need to be open for up to an hour before changes are reflected.
 
-By default, when you run this cmdlet to add an owner, you will not add it as a member. You must run this cmdlet again to add the owner as a member as well.
+To turn an existing Member into an Owner,  first Add-TeamUser -Role Owner -User to add them to the owners list, then Remove-TeamUser -User foo to remove them from the members list.
 
 ## SYNTAX
 
 ```
-Add-TeamUser -GroupId <String> -User <String> [-Role <String>]
+Add-TeamUser -GroupId <String> -User <String> [-Role <String>] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
 
 ## EXAMPLES
 
-### --------------------------  Example 1  --------------------------
+### Example 1
 ```
 Add-TeamUser -GroupId 31f1ff6c-d48c-4f8a-b2e1-abca7fd399df -User [email protected]
 ```
@@ -42,13 +35,12 @@ Add user [email protected] to group.
 ## PARAMETERS
 
 ### -GroupId
-GroupId of the team.
+GroupId of the team
 
 ```yaml
 Type: String
 Parameter Sets: (All)
 Aliases:
-Applicable: Microsoft Teams
 
 Required: True
 Position: Named
@@ -58,13 +50,13 @@ Accept wildcard characters: False
 ```
 
 ### -User
-User's UPN (user principal name - e.g. [email protected]).
+User's UPN (user principal name - e.g.
+[email protected])
 
 ```yaml
 Type: String
 Parameter Sets: (All)
 Aliases:
-Applicable: Microsoft Teams
 
 Required: True
 Position: Named
@@ -74,21 +66,24 @@ Accept wildcard characters: False
 ```
 
 ### -Role
-Member or Owner.
+Member or Owner
 
 ```yaml
 Type: String
 Parameter Sets: (All)
 Aliases:
-Applicable: Microsoft Teams
 
 Required: False
 Position: Named
-Default value: Member
+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
 
 ### GroupId, User, Role
@@ -98,4 +93,3 @@ Accept wildcard characters: False
 ## NOTES
 
 ## RELATED LINKS
-

teams/teams-ps/teams/Connect-MicrosoftTeams.md

@@ -1,19 +1,13 @@
 ---
 external help file: Microsoft.Open.Teams.CommonLibrary.dll-Help.xml
 Module Name: MicrosoftTeams
-applicable: Microsoft Teams
-title: Connect-MicrosoftTeams
-online version: 
+online version:
 schema: 2.0.0
-author: kenwith
-ms.author: kenwith
-ms.reviewer:
 ---
 
 # Connect-MicrosoftTeams
 
 ## SYNOPSIS
-Note: This cmdlet is currently in Beta.
 
 The Connect-MicrosoftTeams cmdlet connects an authenticated account to use for Microsoft Teams cmdlet requests.
 You can use this authenticated account only with Microsoft Teams cmdlets.
@@ -23,25 +17,33 @@ You can use this authenticated account only with Microsoft Teams cmdlets.
 ### UserCredential (Default)
 ```
 Connect-MicrosoftTeams [-TenantId <String>] [-Credential <PSCredential>] [-AccountId <String>]
- [-LogLevel <LogLevel>] [-LogFilePath <String>] [-WhatIf] [-Confirm]
+ [-LogLevel <LogLevel>] [-LogFilePath <String>] [-TeamsEnvironmentName <String>] [-WhatIf] [-Confirm]
+ [<CommonParameters>]
 ```
 
 ### ServicePrincipalCertificate
 ```
 Connect-MicrosoftTeams -TenantId <String> -CertificateThumbprint <String> -ApplicationId <String>
- [-LogLevel <LogLevel>] [-LogFilePath <String>] [-WhatIf] [-Confirm]
+ [-LogLevel <LogLevel>] [-LogFilePath <String>] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
 ### AccessToken
 ```
 Connect-MicrosoftTeams [-TenantId <String>] -AadAccessToken <String> [-MsAccessToken <String>]
- -AccountId <String> [-LogLevel <LogLevel>] [-LogFilePath <String>] [-WhatIf] [-Confirm]
+ -AccountId <String> [-LogLevel <LogLevel>] [-LogFilePath <String>] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 
 ## DESCRIPTION
 
 ## EXAMPLES
 
+### Example 1
+```powershell
+PS C:\> Connect-MicrosoftTeams -TeamsEnvironmentName TeamsGCCH
+```
+
+Specifies that the organization being managed is in the Teams GCC High environment, so connect to that environment.
+
 ## PARAMETERS
 
 ### -AadAccessToken
@@ -50,24 +52,23 @@ Specifies a Azure Active Directory Graph access token.
 ```yaml
 Type: String
 Parameter Sets: AccessToken
-Aliases: 
-Applicable: Microsoft Teams
+Aliases:
 
-Required: False
+Required: True
 Position: Named
 Default value: None
 Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
 ### -AccountId
-Specifies the ID of an account. You must specify the UPN of the user when authenticating with a user access token.
+Specifies the ID of an account.
+You must specify the UPN of the user when authenticating with a user access token.
 
 ```yaml
 Type: String
 Parameter Sets: UserCredential
-Aliases: 
-Applicable: Microsoft Teams
+Aliases:
 
 Required: False
 Position: Named
@@ -79,10 +80,9 @@ Accept wildcard characters: False
 ```yaml
 Type: String
 Parameter Sets: AccessToken
-Aliases: 
-Applicable: Microsoft Teams
+Aliases:
 
-Required: False
+Required: True
 Position: Named
 Default value: None
 Accept pipeline input: False
@@ -95,8 +95,7 @@ Specifies the application ID of the service principal.
 ```yaml
 Type: String
 Parameter Sets: ServicePrincipalCertificate
-Aliases: 
-Applicable: Microsoft Teams
+Aliases:
 
 Required: True
 Position: Named
@@ -106,13 +105,12 @@ Accept wildcard characters: False
 ```
 
 ### -CertificateThumbprint
-Specifies the certificate thumbprint of a digital public key X.509 certificate of a user account that has permission to perform this action. 
+Specifies the certificate thumbprint of a digital public key X.509 certificate of a user account that has permission to perform this action.
 
 ```yaml
 Type: String
 Parameter Sets: ServicePrincipalCertificate
-Aliases: 
-Applicable: Microsoft Teams
+Aliases:
 
 Required: True
 Position: Named
@@ -128,7 +126,6 @@ Prompts you for confirmation before running the cmdlet.
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases: cf
-Applicable: Microsoft Teams
 
 Required: False
 Position: Named
@@ -138,16 +135,15 @@ Accept wildcard characters: False
 ```
 
 ### -Credential
-Specifies a **PSCredential** object.
-For more information about the **PSCredential** object, type Get-Help Get-Credential.
+Specifies a PSCredential object.
+For more information about the PSCredential object, type Get-Help Get-Credential.
 
-The **PSCredential** object provides the user ID and password for organizational ID credentials.
+The PSCredential object provides the user ID and password for organizational ID credentials.
 
 ```yaml
 Type: PSCredential
 Parameter Sets: UserCredential
-Aliases: 
-Applicable: Microsoft Teams
+Aliases:
 
 Required: False
 Position: Named
@@ -164,7 +160,6 @@ Provide a value here if you need to deviate from the default PowerShell log file
 Type: String
 Parameter Sets: (All)
 Aliases:
-Applicable: Microsoft Teams
 
 Required: False
 Position: Named
@@ -175,7 +170,7 @@ Accept wildcard characters: False
 
 ### -LogLevel
 Specifies the log level. 
-The acceptable values for this parameter are: 
+The acceptable values for this parameter are:
 
 - Info
 - Error
@@ -187,8 +182,7 @@ The default value is Info.
 ```yaml
 Type: LogLevel
 Parameter Sets: (All)
-Aliases: 
-Applicable: Microsoft Teams
+Aliases:
 
 Required: False
 Position: Named
@@ -203,8 +197,7 @@ Specifies a Microsoft Graph access token.
 ```yaml
 Type: String
 Parameter Sets: AccessToken
-Aliases: 
-Applicable: Microsoft Teams
+Aliases:
 
 Required: False
 Position: Named
@@ -218,13 +211,12 @@ Specifies the ID of a tenant.
 
 If you do not specify this parameter, the account is authenticated with the home tenant.
 
-You must specify the *TenantId* parameter to authenticate as a service principal or when using Microsoft account.
+You must specify the TenantId parameter to authenticate as a service principal or when using Microsoft account.
 
 ```yaml
 Type: String
 Parameter Sets: UserCredential, AccessToken
 Aliases: Domain, TenantDomain
-Applicable: Microsoft Teams
 
 Required: False
 Position: Named
@@ -237,7 +229,6 @@ Accept wildcard characters: False
 Type: String
 Parameter Sets: ServicePrincipalCertificate
 Aliases: Domain, TenantDomain
-Applicable: Microsoft Teams
 
 Required: True
 Position: Named
@@ -250,12 +241,10 @@ Accept wildcard characters: False
 Shows what would happen if the cmdlet runs.
 The cmdlet is not run.
 
-
 ```yaml
 Type: SwitchParameter
 Parameter Sets: (All)
 Aliases: wi
-Applicable: Microsoft Teams
 
 Required: False
 Position: Named
@@ -264,18 +253,41 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -TeamsEnvironmentName
+Use this setting if your organization is in one of the Teams Government Cloud environments.
+
+Specify "TeamsGCCH" if your organization is in the GCC High Environment.  Specify "TeamsDOD" if your organization is in the DoD Environment. 
+
+```yaml
+Type: String
+Parameter Sets: UserCredential
+Aliases:
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+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
 
 ## NOTES
-
-Tips for troubleshooting:
-1. Confirm SAML 2.0 is being used. 
-IDP is outputting invalid SAML information. Needs to have SAML 2.0 vs. SAML 1.0 for the module to connect.
+Tips for troubleshooting: 1.
+Confirm SAML 2.0 is being used. 
+IDP is outputting invalid SAML information.
+Needs to have SAML 2.0 vs.
+SAML 1.0 for the module to connect.
 You might experience an error if the Identity Provider (IDP) only allows the use of SAML1.0 when trying to auth via basic authentication. 
 Which in turn, isn't expected to work because the cmdlet expects either OAUTH2 (which is used when doing just connect-microsofteams), or SAML2.0.
-2. Confirm you have the latest version of the cmdlet. You can find the version by running: `get-module -listavailable` and then looking for the MicrosoftTeams name and the version to the left of it.
+2.
+Confirm you have the latest version of the cmdlet.
+You can find the version by running: \`get-module -listavailable\` and then looking for the MicrosoftTeams name and the version to the left of it.
 
 ## RELATED LINKS
-