Update Set-CsTeamsAppPermissionPolicy.md

Author: islubin

skype/skype-ps/skype/Set-CsTeamsAppPermissionPolicy.md

@@ -9,6 +9,10 @@ schema: 2.0.0
 
 ## SYNOPSIS
 
+As an admin, you can use app permission policies to enable or block specific apps for your users.  Learn more about the App Setup Policies: https://docs.microsoft.com/en-us/microsoftteams/teams-app-permission-policies.
+
+The existence of this cmdlet is being documented for completeness, but do not use this cmdlet.  **We require that all creation and modification of app permission polices (not including the assignment or removal of policies from users) happens in the Microsoft Teams & Skype for Business Admin Center to ensure that the policy matches your expectations for the end user experience.**
+
 ## SYNTAX
 
 ### Identity (Default)
@@ -28,16 +32,15 @@ Set-CsTeamsAppPermissionPolicy [-Tenant <System.Guid>] [-DefaultCatalogApps <>]
 ```
 
 ## DESCRIPTION
-{{Fill in the Description}}
+
+As an admin, you can use app permission policies to enable or block specific apps for your users.  Learn more about the App Setup Policies: https://docs.microsoft.com/en-us/microsoftteams/teams-app-permission-policies.
+
+The existence of this cmdlet is being documented for completeness, but do not use this cmdlet.  **We require that all creation and modification of app permission polices (not including the assignment or removal of policies from users) happens in the Microsoft Teams & Skype for Business Admin Center to ensure that the policy matches your expectations for the end user experience.**
 
 ## EXAMPLES
 
 ### Example 1
-```powershell
-PS C:\> {{ Add example code here }}
-```
-
-{{ Add example description here }}
+Intentionally omitted.
 
 ## PARAMETERS
 
@@ -57,7 +60,7 @@ Accept wildcard characters: False
 ```
 
 ### -DefaultCatalogApps
-{{Fill DefaultCatalogApps Description}}
+Do not use.
 
 ```yaml
 Type:
@@ -72,7 +75,7 @@ Accept wildcard characters: False
 ```
 
 ### -DefaultCatalogAppsType
-{{Fill DefaultCatalogAppsType Description}}
+Do not use.
 
 ```yaml
 Type: String
@@ -87,7 +90,7 @@ Accept wildcard characters: False
 ```
 
 ### -Description
-{{Fill Description Description}}
+Do not use.
 
 ```yaml
 Type: String
@@ -102,7 +105,7 @@ Accept wildcard characters: False
 ```
 
 ### -Force
-{{Fill Force Description}}
+Do not use.
 
 ```yaml
 Type: SwitchParameter
@@ -117,7 +120,7 @@ Accept wildcard characters: False
 ```
 
 ### -GlobalCatalogApps
-{{Fill GlobalCatalogApps Description}}
+Do not use.
 
 ```yaml
 Type:
@@ -132,7 +135,7 @@ Accept wildcard characters: False
 ```
 
 ### -GlobalCatalogAppsType
-{{Fill GlobalCatalogAppsType Description}}
+Do not use.
 
 ```yaml
 Type: String
@@ -147,7 +150,7 @@ Accept wildcard characters: False
 ```
 
 ### -Identity
-{{Fill Identity Description}}
+Do not use.
 
 ```yaml
 Type: XdsIdentity
@@ -162,7 +165,7 @@ Accept wildcard characters: False
 ```
 
 ### -Instance
-{{Fill Instance Description}}
+Do not use.
 
 ```yaml
 Type: PSObject
@@ -177,7 +180,7 @@ Accept wildcard characters: False
 ```
 
 ### -PrivateCatalogApps
-{{Fill PrivateCatalogApps Description}}
+Do not use.
 
 ```yaml
 Type:
@@ -192,7 +195,7 @@ Accept wildcard characters: False
 ```
 
 ### -PrivateCatalogAppsType
-{{Fill PrivateCatalogAppsType Description}}
+Do not use.
 
 ```yaml
 Type: String
@@ -207,7 +210,7 @@ Accept wildcard characters: False
 ```
 
 ### -Tenant
-{{Fill Tenant Description}}
+Do not use.
 
 ```yaml
 Type: System.Guid