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