Import-CMAADServerApplication
在 Configuration Manager 中建立 Microsoft Entra server 應用程式定義。
語法
Import-CMAADServerApplication
[-AppIdUri <Uri>]
[-AppName] <String>
[-AzureEnvironmentOption <AzureEnvironment>]
[-ClientId] <String>
[-SecretKey] <SecureString>
[-SecretKeyExpiry] <DateTime>
[-TenantId] <String>
[-TenantName] <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
使用此 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
datetime 變數。 第二個命令會使用此日期變數作為秘密金鑰到期日,當其使用提供的詳細數據匯入伺服器應用程式時。
$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 管理中心中指定應用程式註冊專案的應用程式 識別碼 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 Government 雲端 (AzureUSGovernmentCloud
) 。
類型: | AzureEnvironment |
接受的值: | AzurePublicCloud, AzureUSGovernmentCloud |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-ClientId
在 Microsoft Entra 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 入口網站複製此應用程式的秘密金鑰。 當您在 Microsoft Entra ID 中註冊應用程式時,已複製秘密密鑰。
類型: | SecureString |
Position: | 4 |
預設值: | None |
必要: | True |
接受管線輸入: | False |
接受萬用字元: | False |
-SecretKeyExpiry
指定 SecretKey 到期的日期。 當您在 Microsoft Entra ID 中建立應用程式的秘密密鑰時,會設定此值。
類型: | 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