New-GraphApplication

SYNOPSIS

Creates a Graph Application object

SYNTAX

New-GraphApplication [-Name] <String> [-ClientCredential] <PSCredential> [-RedirectUri] <String>
 [-Tenant] <String> [[-Description] <String>] [[-GUID] <Guid>]

DESCRIPTION

Creates a Graph Application object containing data used by various cmdltes to define the parameters of the App registered on Azure AD. This does not make any calls to Azure or the Gtaph API. The Application will be inbeded in the Graph OAuthToken objects. The MSGraphAPI.Application object contains the following properties: Name Name of the Application Description Description of the Application UserAgent The User-Agent header the Application will use to access the Graph API ClientID The Client ID of the Registered Azure App RedirectUri The Redirect URI of the Registered Azure App ClientCredential A PS Crednetial containing the Client ID as the username and the Client Secret as the password UserCredential The Reddit Username and password of the developer account used for a Script application GUID A GUID to identitfy the application wihin this module (not consumed or used by Azure or Graph)

EXAMPLES

-------------------------- EXAMPLE 1 --------------------------

$ClientCredential = Get-Credential

PS C:\> $Params = @{ Name = 'MyGraphApp' Description = 'My Graph Application!' ClientCredential = $ClientCredential RedirectUri = 'https://adataum/ouath?' UserAgent = 'Windows:PowerShell:GraphApplication' } PS C:\> $GraphApp = New-GraphApplication @Params

PARAMETERS

-Name

Name of the Graph App. This does not need to match the name registered on Azure. It is used for convenient identification and ducomentation purposes only.

Type: String
Parameter Sets: (All)
Aliases: AppName

Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-ClientCredential

A PScredential object containging the Client ID as the Username and the Client Secret as the password.

Type: PSCredential
Parameter Sets: (All)
Aliases: ClientInfo

Required: True
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-RedirectUri

Redirect URI as registered on Azure for the App. This must match exactly as entered in the App definition or authentication will fail.

Type: String
Parameter Sets: (All)
Aliases: 

Required: True
Position: 3
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Tenant

The Azure/Office365 Tenant ID. e.g. adadtum.onmicrosft.com

Type: String
Parameter Sets: (All)
Aliases: 

Required: True
Position: 4
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-Description

Description of the Graph App. This is not required or used for anything. It is provided for convenient identification and documentation purposes only.

Type: String
Parameter Sets: (All)
Aliases: 

Required: False
Position: 5
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-GUID

A GUID to identify the application. If one is not perovided, a new GUID will be generated.

Type: Guid
Parameter Sets: (All)
Aliases: 

Required: False
Position: 6
Default value: [system.guid]::NewGuid()
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

INPUTS

OUTPUTS

MSGraphAPI.Application

NOTES

http://psmsgraph.readthedocs.io/en/latest/functions/New-GraphApplication

http://psmsgraph.readthedocs.io/en/latest/functions/Export-GraphApplication

http://psmsgraph.readthedocs.io/en/latest/functions/Import-GraphApplication