New-AzStaticWebAppUserRoleInvitationLink
Description for Creates an invitation link for a user with the role
Note
This is the previous version of our documentation. Please consult the most recent version for up-to-date information.
Syntax
New-AzStaticWebAppUserRoleInvitationLink
-Name <String>
-ResourceGroupName <String>
[-SubscriptionId <String>]
[-Domain <String>]
[-Kind <String>]
[-NumHoursToExpiration <Int32>]
[-Provider <String>]
[-Role <String>]
[-UserDetail <String>]
[-DefaultProfile <PSObject>]
[-Confirm]
[-WhatIf]
[<CommonParameters>]
New-AzStaticWebAppUserRoleInvitationLink
-InputObject <IWebsitesIdentity>
[-Domain <String>]
[-Kind <String>]
[-NumHoursToExpiration <Int32>]
[-Provider <String>]
[-Role <String>]
[-UserDetail <String>]
[-DefaultProfile <PSObject>]
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Description
Description for Creates an invitation link for a user with the role
Examples
Example 1: Create an invitation link for a user with the role
PS C:\> New-AzStaticWebAppUserRoleInvitationLink -ResourceGroupName azure-rg-test -Name staticweb-pwsh02 -Domain 'xxxxxxxxx.azurestaticapps.net' -Provider 'github' -UserDetail 'UserName' -Role 'reader' -NumHoursToExpiration 1
Kind Name Type
---- ---- ----
078284a9-ce47-4aa5-b54c-2e55a67dd53c Microsoft.Web/staticSites/invitations
This command creates an invitation link for a user with the role.
Example 2: Create an invitation link for a user with the role by pipeline
PS C:\> $web = Get-AzStaticWebApp -ResourceGroupName resourceGroup -Name staticweb00
PS C:\> New-AzStaticWebAppUserRoleInvitationLink -InputObject $web -Domain 'Hostname' -Provider 'github' -UserDetail 'UserName' -Role 'admin,contributor' -NumHoursToExpiration 1
This command creates an invitation link for a user with the role by pipeline.
Parameters
Prompts you for confirmation before running the cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
The credentials, account, tenant, and subscription used for communication with Azure.
| Type: | PSObject |
| Aliases: | AzureRMContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
The domain name for the static site custom domain.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.
| Type: | IWebsitesIdentity |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Kind of resource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Name of the static site.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
The number of hours the sas token stays valid
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
The identity provider for the static site user.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Name of the resource group to which the resource belongs.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
The roles for the static site user, in free-form string format
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Your Azure subscription ID. This is a GUID-formatted string (e.g. 00000000-0000-0000-0000-000000000000).
| Type: | String |
| Position: | Named |
| Default value: | (Get-AzContext).Subscription.Id |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
The user id for the static site user.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Shows what would happen if the cmdlet runs. The cmdlet is not run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Inputs
Outputs
IStaticSiteUserInvitationResponseResource
Notes
ALIASES
COMPLEX PARAMETER PROPERTIES
To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables.
INPUTOBJECT : Identity Parameter
[Authprovider <String>]: The auth provider for the users.[DomainName <String>]: The custom domain name.[EnvironmentName <String>]: The stage site identifier.[FunctionAppName <String>]: Name of the function app registered with the static site build.[Id <String>]: Resource identity path[Location <String>]: Location where you plan to create the static site.[Name <String>]: Name of the static site.[PrivateEndpointConnectionName <String>]: Name of the private endpoint connection.[ResourceGroupName <String>]: Name of the resource group to which the resource belongs.[SubscriptionId <String>]: Your Azure subscription ID. This is a GUID-formatted string (e.g. 00000000-0000-0000-0000-000000000000).[Userid <String>]: The user id of the user.