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 管理员已使用 Microsoft Entra ID 创建了应用。 在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

在 Microsoft Entra 管理中心中指定应用注册条目的应用程序 ID URI。 此值在Microsoft Entra租户中必须是唯一的。 它位于 Configuration Manager 客户端用于请求对服务的访问权限的访问令牌中。 格式类似于 https://ConfigMgrService.

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

-AppName

指定应用的友好名称。 此值是应用注册中的显示名称。

Type:String
Aliases:ApplicationName
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AzureEnvironmentOption

指定此应用注册是全局 Azure 云 () AzurePublicCloud ,还是Azure 政府云 (AzureUSGovernmentCloud) 。

Type:AzureEnvironment
Accepted values:AzurePublicCloud, AzureUSGovernmentCloud
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClientId

Microsoft Entra ID 中指定应用注册的应用程序 (客户端) ID 值。 格式是标准 GUID。

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

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

-ForceWildcardHandling

此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。

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

-SecretKey

指定从Azure 门户复制的此应用的密钥。 在Microsoft Entra ID 中注册应用时,你复制了密钥。

Type:SecureString
Position:4
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SecretKeyExpiry

指定 SecretKey 到期的日期。 使用 id 为应用创建密钥时,可以配置此值Microsoft Entra。

Type:DateTime
Position:5
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TenantId

指定Microsoft Entra租户的 GUID。

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TenantName

指定Microsoft Entra租户的名称。

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

显示在 cmdlet 运行时发生的情况。 该 cmdlet 未运行。

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

输入

None

输出

IResultObject