Feature: added file and folder sharing invite cmdlets

documentation/Add-PnPFileSharingInvite.md

@@ -0,0 +1,167 @@
+---
+Module Name: PnP.PowerShell
+schema: 2.0.0
+applicable: SharePoint Online
+online version: https://pnp.github.io/powershell/cmdlets/Add-PnPFileSharingInvite.html
+external help file: PnP.PowerShell.dll-Help.xml
+title: Add-PnPFileSharingInvite
+---
+
+# Add-PnPFileSharingInvite
+
+## SYNOPSIS
+Creates an invitation for users to a file.
+
+## SYNTAX
+
+```powershell
+Add-PnPFileSharingInvite -FileUrl <String> -Users <String[]> -Message <String> -RequireSignIn <SwitchParameter> -SendInvitation <SwitchParameter> -Role <PermissionRole> -ExpirationDateTime <DateTime> [-Connection <PnPConnection>] 
+```
+
+## DESCRIPTION
+
+Creates an invitation for users to a file.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```powershell
+Add-PnPFileSharingInvite -FileUrl "/sites/demo/Shared Documents/Test.docx" -Users "john@contoso.onmicrosoft.com" -RequireSignIn
+```
+
+This will invite the user `John@contoso.onmicrosoft.com` to the `Test.docx` file with Read permissions and will require that user to sign in before accessing the file.
+
+### EXAMPLE 2
+```powershell
+Add-PnPFileSharingInvite -FileUrl "/sites/demo/Shared Documents/Test.docx" -Users "john@contoso.onmicrosoft.com" -RequireSignIn -SendInvitation -Role Owner
+```
+
+This will invite the user `John@contoso.onmicrosoft.com` to the `Test.docx` file with Read permissions and will require that user to sign in before accessing the file. The invitation will be sent and the user will have `Owner` permissions
+
+### EXAMPLE 3
+```powershell
+Add-PnPFileSharingInvite -FileUrl "/sites/demo/Shared Documents/Test.docx" -Users "john@contoso.onmicrosoft.com" -RequireSignIn -ExpirationDate (Get-Date).AddDays(15)
+```
+
+This will invite the user `John@contoso.onmicrosoft.com` to the `Test.docx` file with Read permissions and will require that user to sign in before accessing the file. The link will expire after 15 days.
+
+## PARAMETERS
+
+### -Connection
+Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
+
+```yaml
+Type: PnPConnection
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -FileUrl
+The FileUrl in the site
+
+```yaml
+Type: String
+Parameter Sets: (All)
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Users
+A collection of recipients who will receive access and the sharing invitation.
+**Currently, only one user at a time is supported**. We are planning to add support for multiple users a bit later.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Message
+A plain text formatted message that is included in the sharing invitation. Maximum length 2000 characters.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -RequireSignIn
+Specifies where the recipient of the invitation is required to sign-in to view the shared item
+
+```yaml
+Type: SwitchParamter
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -SendInvitation
+Specifies if an email or post is generated (false) or if the permission is just created (true).
+
+```yaml
+Type: SwitchParamter
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Role
+Specify the role that is to be granted to the recipients of the sharing invitation.
+
+Supported values are `Owner`, `Write` and `Read`.
+
+```yaml
+Type: PnP.Core.Model.Security.PermissionRole
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: Read
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ExpirationDateTime
+The expiration date for the FileUrl after which the permission expires.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+## RELATED LINKS
+
+[Microsoft 365 Patterns and Practices](https://aka.ms/m365pnp)

documentation/Add-PnPFolderAnonymousSharingLink.md

@@ -38,7 +38,7 @@ Add-PnPFolderAnonymousSharingLink -Folder "/sites/demo/Shared Documents/Test" -T
 
 This will create an anonymous sharing link for `Test` folder in the `Shared Documents` library which will be editable by anonymous users with the specified password.
 
-### EXAMPLE 2
+### EXAMPLE 3
 ```powershell
 Add-PnPFolderAnonymousSharingLink -Folder "/sites/demo/Shared Documents/Test" -Type Edit -Password "PnPRocks!" -ExpirationDateTime (Get-Date).AddDays(15)
 ```

documentation/Add-PnPFolderSharingInvite.md

@@ -0,0 +1,167 @@
+---
+Module Name: PnP.PowerShell
+schema: 2.0.0
+applicable: SharePoint Online
+online version: https://pnp.github.io/powershell/cmdlets/Add-PnPFolderSharingInvite.html
+external help file: PnP.PowerShell.dll-Help.xml
+title: Add-PnPFolderSharingInvite
+---
+
+# Add-PnPFolderSharingInvite
+
+## SYNOPSIS
+Creates an invitation for users to a folder.
+
+## SYNTAX
+
+```powershell
+Add-PnPFolderSharingInvite -Folder <FolderPipeBind> -Users <String[]> -Message <String> -RequireSignIn <SwitchParameter> -SendInvitation <SwitchParameter> -Role <PermissionRole> -ExpirationDateTime <DateTime> [-Connection <PnPConnection>] 
+```
+
+## DESCRIPTION
+
+Creates an invitation for user to a folder.
+
+## EXAMPLES
+
+### EXAMPLE 1
+```powershell
+Add-PnPFolderSharingInvite -Folder "/sites/demo/Shared Documents/Test" -Users "john@contoso.onmicrosoft.com" -RequireSignIn
+```
+
+This will invite the user `John@contoso.onmicrosoft.com` to the `Test` folder with Read permissions and will require that user to sign in before accessing the folder.
+
+### EXAMPLE 2
+```powershell
+Add-PnPFolderSharingInvite -Folder "/sites/demo/Shared Documents/Test" -Users "john@contoso.onmicrosoft.com" -RequireSignIn -SendInvitation -Role Owner
+```
+
+This will invite the user `John@contoso.onmicrosoft.com` to the `Test` folder with Read permissions and will require that user to sign in before accessing the folder. The invitation will be sent and the user will have `Owner` permissions
+
+### EXAMPLE 3
+```powershell
+Add-PnPFolderSharingInvite -Folder "/sites/demo/Shared Documents/Test" -Users "john@contoso.onmicrosoft.com" -RequireSignIn -ExpirationDate (Get-Date).AddDays(15)
+```
+
+This will invite the user `John@contoso.onmicrosoft.com` to the `Test` folder with Read permissions and will require that user to sign in before accessing the folder. The link will expire after 15 days.
+
+## PARAMETERS
+
+### -Connection
+Optional connection to be used by the cmdlet. Retrieve the value for this parameter by either specifying -ReturnConnection on Connect-PnPOnline or by executing Get-PnPConnection.
+
+```yaml
+Type: PnPConnection
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Folder
+The folder in the site
+
+```yaml
+Type: FolderPipeBind
+Parameter Sets: (All)
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Users
+A collection of recipients who will receive access and the sharing invitation.
+**Currently, only one user at a time is supported**. We are planning to add support for multiple users a bit later.
+
+```yaml
+Type: String[]
+Parameter Sets: (All)
+
+Required: True
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Message
+A plain text formatted message that is included in the sharing invitation. Maximum length 2000 characters.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -RequireSignIn
+Specifies where the recipient of the invitation is required to sign-in to view the shared item
+
+```yaml
+Type: SwitchParamter
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -SendInvitation
+Specifies if an email or post is generated (false) or if the permission is just created (true).
+
+```yaml
+Type: SwitchParamter
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -Role
+Specify the role that is to be granted to the recipients of the sharing invitation.
+
+Supported values are `Owner`, `Write` and `Read`.
+
+```yaml
+Type: PnP.Core.Model.Security.PermissionRole
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: Read
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -ExpirationDateTime
+The expiration date for the folder after which the permission expires.
+
+```yaml
+Type: String
+Parameter Sets: (All)
+
+Required: False
+Position: Named
+Default value: None
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+## RELATED LINKS
+
+[Microsoft 365 Patterns and Practices](https://aka.ms/m365pnp)