Import-CMAADServerApplication
在 Configuration Manager 中创建Microsoft Entra 服务器应用定义。
语法
Import-CMAADServerApplication
[-AppIdUri <Uri>]
[-AppName] <String>
[-AzureEnvironmentOption <AzureEnvironment>]
[-ClientId] <String>
[-SecretKey] <SecureString>
[-SecretKeyExpiry] <DateTime>
[-TenantId] <String>
[-TenantName] <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
使用此 cmdlet 从 Microsoft Entra ID 导入服务器应用,并为 Configuration Manager 站点定义它。 它假定 Azure 管理员已使用 Entra ID Microsoft 创建了应用。 在 Microsoft Entra ID 中,此应用称为 Web 应用注册。
有关如何使用此 cmdlet (CMG) 创建云管理网关的详细信息,请参阅 2010 发行说明:云管理网关。
有关在 Configuration Manager 中Microsoft Entra 应用的详细信息,请参阅 配置 Azure 服务。
注意
此 cmdlet 可能适用于其他 Azure 服务,但仅使用 云管理 连接对其进行测试,以支持云管理网关 (CMG) 。
示例
示例 1
在此示例中,第一个命令为 11/16/2021
创建日期/时间变量。 第二个命令使用此日期变量作为密钥到期日期,当它使用提供的详细信息导入服务器应用时。
$date = [datetime]::parseexact("11/16/2021", 'MM/dd/yyyy', $null)
Import-CMAADServerApplication -TenantName "Contoso" -TenantId "05a349fa-298a-4427-8771-9efcdb73431e" -AppName "CmgServerApp" -ClientId "7078946d-fc1c-43b7-8dee-dd6e6b00d783" -SecretKey "1uXGR^!0@Cjas6qI*J02ZeS&&zY19^hC*9" -SecretKeyExpiry $date
参数
-AppIdUri
在 Entra 管理中心Microsoft指定应用注册条目的应用程序 ID URI 。 此值在 Microsoft Entra 租户中必须是唯一的。 它位于 Configuration Manager 客户端用于请求对服务的访问权限的访问令牌中。 格式类似于 https://ConfigMgrService.
类型: | Uri |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-AppName
指定应用的友好名称。 此值是应用注册中的显示名称。
类型: | String |
别名: | ApplicationName |
Position: | 2 |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-AzureEnvironmentOption
指定此应用注册是在全球 Azure 云 () AzurePublicCloud
中,还是 Azure 政府云 (AzureUSGovernmentCloud
) 。
类型: | AzureEnvironment |
接受的值: | AzurePublicCloud, AzureUSGovernmentCloud |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ClientId
Microsoft Entra ID 中指定应用注册的应用程序 (客户端) ID 值。 格式是标准 GUID。
类型: | String |
Position: | 3 |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-SecretKey
指定从 Azure 门户复制的此应用的密钥。 在 Entra ID Microsoft注册应用时复制了密钥。
类型: | SecureString |
Position: | 4 |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-SecretKeyExpiry
指定 SecretKey 到期的日期。 在 Entra ID Microsoft中创建应用的密钥时,可以配置此值。
类型: | DateTime |
Position: | 5 |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-TenantId
指定 Microsoft Entra 租户的 GUID。
类型: | String |
Position: | 1 |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-TenantName
指定Microsoft Entra 租户的名称。
类型: | String |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 该 cmdlet 未运行。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
None
输出
IResultObject