Add-​CM​Intune​Subscription

Adds a Microsoft Intune subscription.

Syntax

Add-CMIntuneSubscription
   [-ColorScheme <Color>]
   [-CompanyLogoPath <String>]
   [-CompanyLogoThemedPath <String>]
   -CompanyName <String>
   [-CompanyNameWithLogo]
   [-Confirm]
   [-ContactAdditional <String>]
   [-ContactEmail <String>]
   [-ContactName <String>]
   [-ContactPhoneNumber <String>]
   [-DisableWildcardHandling]
   [-Force]
   [-ForceWildcardHandling]
   -IntuneCredential <PSCredential>
   [-MaximumUserDevice <Int32>]
   [-MultifactorEnabled]
   [-OnPremOnly]
   [-PrivacyUrl <String>]
   [-SiteCode <String>]
   [-SupportSiteName <String>]
   [-SupportUrl <String>]
   -UserCollection <IResultObject>
   [-WhatIf]
   [<CommonParameters>]

Description

The Add-CMIntuneSubscription cmdlet adds a Microsoft Intune subscription to Microsoft System Center Configuration Manager. You must provide credentials for a Microsoft Intune organizational account.

NOTE: You can only add a Microsoft Intune subscription to a Central Administration Site or a stand-alone primary site.

Examples

Example 1: Add a Microsoft Intune subscription

PS C:\> $SecPasswd = ConvertTo-SecureString "P@ssW0rD! -AsPlainText -Force
PS C:\> MyCreds = New-Object System.Management.Automation.PSCredential ("AccountName@CompanyName.onmicrosoft.com", $SecPasswd)
PS C:\> $UC = Get-CMUserCollection -Name "All Users"
PS C:\> Add-CMIntuneSubscription -CompanyName "CompanyName" -IntuneCredential $MyCreds -UserCollection $UC

The first command converts a password into a secure string and stores the secure string in the $SecPasswd variable.

The second command creates a PSCredential object with a Microsoft Intune organizational account and the password stored in $SecPassword. The command then stores the PSCredential object in the $MyCreds variable.

The third command gets the user collection object named "All Users" and stores the object in the $UC variable.

The last command adds a Microsoft Intune subscription using the Intune credentials stored in $MyCreds, and the user collection stored in $UC.

Required Parameters

-CompanyName

Specifies a company name.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-IntuneCredential

Specifies, as a PSCredential, a Microsoft Intune organizational account and password.

Type:PSCredential
Aliases:Credentials, Credential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-UserCollection

Specifies a user collection. To obtain a user collection object, use the Get-CMUserCollection or Get-CMCollection cmdlet. Members of this user collection will be able to enroll their devices for management.

Type:IResultObject
Aliases:Collection
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-ColorScheme

Specifies a color scheme for the company portal.

Type:Color
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CompanyLogoPath

Specifies the path to the company logo to use when the company portal background is white.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CompanyLogoThemedPath

Specifies the path to the company logo to use when the company portal background has a color scheme.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CompanyNameWithLogo

Indicates that the company name is displayed next to the company logo.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-ContactAdditional

Specifies additional company contact information.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ContactEmail

Specifies the IT department email address.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ContactName

Specifies the IT department contact name.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ContactPhoneNumber

Specifies the IT department phone number.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Force

Forces the command to run without asking for user confirmation.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MaximumUserDevice

Specifies the maximum number of devices that a user can enroll.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MultifactorEnabled

Indicates that multi-factor authentication is enabled. This applies to Windows 8.1 or later and Windows Phone 8.1 or later device enrollment.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-OnPremOnly

Indicates that only devices on premises are managed. Information from devices on premises do not replicate to the cloud.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PrivacyUrl

Specifies the URL to company privacy documentation.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SiteCode

Specifies the Configuration Manager site code for device assignment.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SupportSiteName

Specifies the name of the support website. The website name is displayed to users.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SupportUrl

Specifies the URL to the support website. The URL is not displayed to users.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False