Merge pull request #317 from OfficeDev/dev

May 2016 Release

Author: erwinvanhunen

Binaries/SharePointPnPPowerShell2013.msi

@@ -63,14 +63,14 @@ in a cmdlet that extens SPOWebCmdlet, the cmdlet will switch it's internal conte
 var context = SelectedWeb.Context;
 ```
 ###Cmdlets will have to work both on-premises and in the cloud
-You can use preprocessor variables ("CLIENTSDKV15" and "CLIENTSDKV16") to build different cmdlets for the different targets. In cases where it is not possible to provide functionality for either the 
-cloud or on-premises, make sure to remove the full cmdlet from the compiled solution by having #IF(!CLIENTSDKV15) or #IF(CLIENTSDKV15) as the _first line of the cmdlet, before using statements. 
+You can use preprocessor variables ("ONPREMISES" or "SP2013" and "SP2016") to build different cmdlets for the different targets. In cases where it is not possible to provide functionality for either the 
+cloud or on-premises, make sure to remove the full cmdlet from the compiled solution by having #IF(!SP2013) or #IF(SP2013) as the _first line of the cmdlet, before using statements. 
 
 See the following example
 
 
 ```csharp
-#if !CLIENTSDKV15
+#if !ONPREMISES
 using Microsoft.SharePoint.Client;
 
 public class MyCmdlet : SPOWebCmdlet
@@ -80,7 +80,7 @@ public class MyCmdlet : SPOWebCmdlet
 #endif
 ```
 
-If only parts of a cmdlet require different behaviour based upon the different version of the SDK, you are recommended to use the #CLIENTSDKV15 preprocessor variable throughout your code to exclude or include certain code.
+If only parts of a cmdlet require different behaviour based upon the different version of the SDK, you are recommended to use the #ONPREMISES or other available preprocessor variable throughout your code to exclude or include certain code.
 
 ###Cmdlets will have to use common verbs
 

Binaries/SharePointPnPPowerShell2016.msi

@@ -1,10 +1,6 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
+using System.Collections.Generic;
 
-namespace OfficeDevPnP.PowerShell.CmdletHelpGenerator
+namespace SharePointPnP.PowerShell.CmdletHelpGenerator
 {
     public class CmdletInfo
     {

Binaries/SharePointPnPPowerShellOnline.msi

@@ -1,10 +1,4 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace OfficeDevPnP.PowerShell.CmdletHelpGenerator
+namespace SharePointPnP.PowerShell.CmdletHelpGenerator
 {
     public class CmdletParameterInfo
     {

CONTRIBUTING.md

@@ -1,6 +1,6 @@
 using System.Collections.Generic;
 
-namespace OfficeDevPnP.PowerShell.CmdletHelpGenerator
+namespace SharePointPnP.PowerShell.CmdletHelpGenerator
 {
     public class CmdletSyntax
     {

CmdletHelpGenerator/CmdletInfo.cs

@@ -3,15 +3,13 @@
 using System.Linq;
 using System.Management.Automation;
 using System.Reflection;
-using System.Security.Cryptography;
 using System.Text;
 using System.Xml.Linq;
-using OfficeDevPnP.PowerShell.CmdletHelpAttributes;
-using System.Text.RegularExpressions;
+using SharePointPnP.PowerShell.CmdletHelpAttributes;
 using System.Runtime.Serialization;
 using System.IO;
 
-namespace OfficeDevPnP.PowerShell.CmdletHelpGenerator
+namespace SharePointPnP.PowerShell.CmdletHelpGenerator
 {
     class Program
     {

CmdletHelpGenerator/CmdletParameterInfo.cs

@@ -7,8 +7,8 @@
     <ProjectGuid>{B53C2D73-E46B-47E1-BB80-C2A363A53FB3}</ProjectGuid>
     <OutputType>Exe</OutputType>
     <AppDesignerFolder>Properties</AppDesignerFolder>
-    <RootNamespace>OfficeDevPnP.PowerShell.CmdletHelpGenerator</RootNamespace>
-    <AssemblyName>OfficeDevPnP.PowerShell.CmdletHelpGenerator</AssemblyName>
+    <RootNamespace>SharePointPnP.PowerShell.CmdletHelpGenerator</RootNamespace>
+    <AssemblyName>SharePointPnP.PowerShell.CmdletHelpGenerator</AssemblyName>
     <TargetFrameworkVersion>v4.5</TargetFrameworkVersion>
     <FileAlignment>512</FileAlignment>
     <SccProjectName>
@@ -74,6 +74,26 @@
     <CodeAnalysisRuleSet>MinimumRecommendedRules.ruleset</CodeAnalysisRuleSet>
     <Prefer32Bit>true</Prefer32Bit>
   </PropertyGroup>
+  <PropertyGroup Condition="'$(Configuration)|$(Platform)' == 'Debug16|AnyCPU'">
+    <DebugSymbols>true</DebugSymbols>
+    <OutputPath>bin\Debug16\</OutputPath>
+    <DefineConstants>DEBUG;TRACE</DefineConstants>
+    <DebugType>full</DebugType>
+    <PlatformTarget>AnyCPU</PlatformTarget>
+    <ErrorReport>prompt</ErrorReport>
+    <CodeAnalysisRuleSet>MinimumRecommendedRules.ruleset</CodeAnalysisRuleSet>
+    <Prefer32Bit>true</Prefer32Bit>
+  </PropertyGroup>
+  <PropertyGroup Condition="'$(Configuration)|$(Platform)' == 'Release16|AnyCPU'">
+    <OutputPath>bin\Release16\</OutputPath>
+    <DefineConstants>TRACE</DefineConstants>
+    <Optimize>true</Optimize>
+    <DebugType>pdbonly</DebugType>
+    <PlatformTarget>AnyCPU</PlatformTarget>
+    <ErrorReport>prompt</ErrorReport>
+    <CodeAnalysisRuleSet>MinimumRecommendedRules.ruleset</CodeAnalysisRuleSet>
+    <Prefer32Bit>true</Prefer32Bit>
+  </PropertyGroup>
   <ItemGroup>
     <Reference Include="System" />
     <Reference Include="System.Core" />
@@ -101,9 +121,9 @@
     <None Include="App.config" />
   </ItemGroup>
   <ItemGroup>
-    <ProjectReference Include="..\HelpAttributes\OfficeDevPnP.PowerShell.CmdletHelpAttributes.csproj">
+    <ProjectReference Include="..\HelpAttributes\SharePointPnP.PowerShell.CmdletHelpAttributes.csproj">
       <Project>{fdd50bbd-ae78-4b10-9549-0566686719ab}</Project>
-      <Name>OfficeDevPnP.PowerShell.CmdletHelpAttributes</Name>
+      <Name>SharePointPnP.PowerShell.CmdletHelpAttributes</Name>
     </ProjectReference>
   </ItemGroup>
   <ItemGroup>

CmdletHelpGenerator/CmdletSyntax.cs

@@ -1,23 +1,22 @@
-#if !CLIENTSDKV15
+#if !ONPREMISES
 using System.ComponentModel;
 using System.Linq;
 using System.Management.Automation;
 using Microsoft.SharePoint.Client;
-using OfficeDevPnP.PowerShell.CmdletHelpAttributes;
-using OfficeDevPnP.PowerShell.Commands.Base;
-using OfficeDevPnP.PowerShell.Commands.Enums;
-using Resources = OfficeDevPnP.PowerShell.Commands.Properties.Resources;
+using SharePointPnP.PowerShell.CmdletHelpAttributes;
+using SharePointPnP.PowerShell.Commands.Base;
+using SharePointPnP.PowerShell.Commands.Enums;
+using Resources = SharePointPnP.PowerShell.Commands.Properties.Resources;
 
-namespace OfficeDevPnP.PowerShell.Commands
+namespace SharePointPnP.PowerShell.Commands
 {
 
     [Cmdlet(VerbsCommon.Get, "SPOTenantSite", SupportsShouldProcess = true)]
-    [CmdletHelp(@"Office365 only: Uses the tenant API to retrieve site information.
-", Category = CmdletHelpCategory.TenantAdmin)]
-    [CmdletExample(Code = @"
-PS:> Get-SPOTenantSite", Remarks = "Returns all site collections", SortOrder = 1)]
-    [CmdletExample(Code = @"
-PS:> Get-SPOTenantSite -Url http://tenant.sharepoint.com/sites/projects", Remarks = "Returns information about the project site.",SortOrder = 2)]
+    [CmdletHelp(@"Office365 only: Uses the tenant API to retrieve site information.", Category = CmdletHelpCategory.TenantAdmin)]
+    [CmdletExample(Code = @"PS:> Get-SPOTenantSite", Remarks = "Returns all site collections", SortOrder = 1)]
+    [CmdletExample(Code = @"PS:> Get-SPOTenantSite -Url http://tenant.sharepoint.com/sites/projects", Remarks = "Returns information about the project site.",SortOrder = 2)]
+    [CmdletExample(Code = @"PS:> Get-SPOTenantSite -Detailed", Remarks = "Returns all sites with the full details of these sites", SortOrder = 3)]
+    [CmdletExample(Code = @"PS:> Get-SPOTenantSite -IncludeOneDriveSites", Remarks = "Returns all sites including all OneDrive 4 Business sites", SortOrder = 4)]
     public class GetTenantSite : SPOAdminCmdlet
     {
         [Parameter(Mandatory = false, HelpMessage = "The URL of the site", Position = 0, ValueFromPipeline = true)]
@@ -27,10 +26,10 @@ public class GetTenantSite : SPOAdminCmdlet
         [Parameter(Mandatory = false, HelpMessage = "By default, not all returned attributes are populated. This switch populates all attributes. It can take several seconds to run. Without this, some attributes will show default values that may not be correct.")]
         public SwitchParameter Detailed;
 
-        [Parameter(Mandatory = false)]
+        [Parameter(Mandatory = false, HelpMessage = "By default, the OneDrives are not returned. This switch includes all OneDrives. This can take some extra time to run")]
         public SwitchParameter IncludeOneDriveSites;
 
-        [Parameter(Mandatory = false)]
+        [Parameter(Mandatory = false, HelpMessage = "When the switch IncludeOneDriveSites is used, this switch ignores the question shown that the command can take a long time to execute")]
         public SwitchParameter Force;
 
         protected override void ExecuteCmdlet()