Add-CMAssetIntelligenceSynchronizationPoint
Add-CMAssetIntelligenceSynchronizationPoint
Installs an Asset Intelligence synchronization point.
Syntax
Parameter Set: AISyncPoint
Add-CMAssetIntelligenceSynchronizationPoint -SiteSystemServerName <String> [-CertificateFile <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: AISyncPointWithSchedule
Add-CMAssetIntelligenceSynchronizationPoint -EnableSynchronization -ScheduleToken <IResultObject> -SiteSystemServerName <String> [-CertificateFile <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Add-CMAssetIntelligenceSynchronizationPoint cmdlet installs an Asset Intelligence synchronization point. Microsoft System Center 2012 Configuration Manager uses the Asset Intelligence synchronization point site system role to connect System Center 2012 Configuration Manager sites to System Center Online to synchronize Asset Intelligence catalog information.
You can install the Asset Intelligence synchronization point only on a site system located at the top-level site of the System Center 2012 Configuration Manager hierarchy.
Parameters
-CertificateFile<String>
Specifies the path to a System Center Online authentication certificate (.pfx) file.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-EnableSynchronization
Indicates that the Asset Intelligence synchronization point is enabled.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ScheduleToken<IResultObject>
Specifies a Configuration Manager schedule object from another cmdlet. You can use the New-CMSchedule cmdlet to create a schedule token.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SiteSystemServerName<String>
Specifies an array of fully qualified domain names (FQDN) of the servers that host the site system role.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1: Install an Asset Intelligence synchronization point
This command installs an Asset Intelligence synchronization point on the System Center 2012 Configuration Manager site that has the site code CM4 on the site system server named CMDIV-TSQA04.CORP.CONTOSO.COM. The Asset Intelligence synchronization point uses the proxy server named "AIproxy.tsqa.corp.contoso.com" and uses port 8080 for the connection to System Center Online.
PS C:\> Add-CMAssetIntelligenceSynchronizationPoint -SiteSystemName "CMDIV-TSQA04.CORP.CONTOSO.COM" -SiteCode "CM4" -UseProxy $true -ProxyName "AIproxy.tsqa.corp.contoso.com" -ProxyServerPort 8080
Example 2: Install a scheduled Asset Intelligence synchronization point
This first command creates a System Center 2012 Configuration Manager schedule token that specifies an event that occurs once a week for three weeks on Fridays. The command stores the results in the $Sc variable.
The second command installs an Asset Intelligence synchronization point on the System Center 2012 Configuration Manager site that has the site code CM4 on the site system server named CMDIV-TSQA04.CORP.CONTOSO.COM. The Asset Intelligence synchronization point uses the proxy server named "AIproxy.tsqa.corp.contoso.com" and uses the AIproxyacct\Contoso user account for authenticating the proxy server.
The command enables the Asset Intelligence synchronization point and specifies the System Center Online authentication certificate (.pfx) file, and specifies that the connection to System Center Online use port 8080. The command specifies the schedule for the synchronization point stored in the $Sc variable.
PS C:\> $Sc = New-CMSchedule -DayOfWeek Friday -RecurCount 2
PS C:\>Add-CMAssetIntelligenceSynchronizationPoint -SiteSystemName "CMDIV-TSQA04.CORP.CONTOSO.COM" -SiteCode "CM4" -UseProxy $true -ProxyName "AIproxy.tsqa.corp.contoso.com" -UserName "AIproxyacct\Contoso" -CertificateFile "\\Contoso01\CM\ACDataFile\AIpfx.pfx" -EnableSynchronization -ScheduleToken $Sc -ProxyServerPort 8080
Related topics
Get-CMAssetIntelligenceSynchronizationPoint
Remove-CMAssetIntelligenceSynchronizationPoint