Skip to content

Latest commit

 

History

History
167 lines (117 loc) · 4.19 KB

File metadata and controls

167 lines (117 loc) · 4.19 KB
external help file Microsoft.Online.SharePoint.PowerShell.dll-Help.xml
Module Name Microsoft.Online.SharePoint.PowerShell
online version https://learn.microsoft.com/powershell/module/microsoft.online.sharepoint.powershell/New-SPOAppBillingPolicy
applicable SharePoint Online
title New-SPOAppBillingPolicy
schema 2.0.0
author arakesh
ms.author arakesh
ms.reviewer

New-SPOAppBillingPolicy

SYNOPSIS

Creates a new billing policy for an application owned by the tenant.

SYNTAX

New-SPOAppBillingPolicy -ApplicationId <Guid> -UsageCharges <String> -AzureSubscriptionId <Guid>
 -ResourceGroup <String> -AzureRegion <String> [<CommonParameters>]

DESCRIPTION

This cmdlet creates a new billing policy for an application that is owned by the tenant running the cmdlet.

You must be a SharePoint Administrator to run this cmdlet.

Note

To use the New-SPOAppBillingPolicy cmdlet, an admin must authenticate to SharePoint Online using modern authentication.

Use the Connect-SPOService cmdlet shown below, which will prompt you to enter your credentials. If multi-factor authentication (MFA) is enabled, you will need to complete the MFA process (e.g., entering a verification code sent to your phone).

Connect-SPOService -Url https://(your-tenant)-admin.sharepoint.com

Replace (your-tenant) with your actual SharePoint Online domain, e.g. https://contoso-admin.sharepoint.com.

EXAMPLES

Example 1

New-SPOAppBillingPolicy -ApplicationId 50785fde-3082-47ac-a36d-06282ac5c7da  -AzureSubscriptionId c7170373-eb8d-4984-8cc9-59bcc88c65a0 -ResouceGroup "SPOPAYG" -AzureRegion "Uk-South" -UsageCharges AppOwnerIsCharged

Example 2

New-SPOAppBillingPolicy -ApplicationId 50785fde-3082-47ac-a36d-06282ac5c7da  -AzureSubscriptionId c7170373-eb8d-4984-8cc9-59bcc88c65a0 -ResouceGroup "SPOPAYG" -AzureRegion "Uk-South" -UsageCharges ConsumingTenantOfTheAppisCharged

PARAMETERS

-ApplicationID

Applicable: SharePoint Online

This parameter specifies the ID of the application.

Type: System.Guid
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AzureRegion

Applicable: SharePoint Online

The region of the Azure Subscription.

Type: System.String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-AzureSubscriptionId

Applicable: SharePoint Online

The unique identifier of the Azure Active Directory profile (Microsoft Entra ID) for billing purposes.

Type: System.Guid
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ResourceGroup

Applicable: SharePoint Online

Resource Group Name associated with the Azure Subscription

Type: System.String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-UsageCharges

Applicable: SharePoint Online

This parameters determined who is charged for the usage of the application. This parameter supports two values - AppOwnerIsCharged or ConsumingTenantoftheAppischarged.

  • AppOwnerIsCharged : The tenant owning the application is charged for the usage
  • ConsumingTenantoftheAppischarged : The tenant using the application is charged for the usage.
Type: System.String
Parameter Sets: (All)
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

None

OUTPUTS

System.Object

NOTES

RELATED LINKS

Getting started with SharePoint Online Management Shell