zh-Hant/Microsoft.Open.Azure.AD.CommonLibrary.dll-Help.xml
<?xml version="1.0" encoding="utf-8"?>
<helpItems schema="maml"> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details><command:name>Connect-AzureAD</command:name> <command:verb>Connect</command:verb> <command:noun>AzureAD</command:noun> <maml:description><maml:para>Connects with an authenticated account to use Active Directory cmdlet requests. </maml:para> </maml:description> </command:details> <maml:description><maml:para>The Connect-AzureAD cmdlet connects an authenticated account to use for Azure Active Directory cmdlet requests. </maml:para> <maml:para>You can use this authenticated account only with Azure Active Directory cmdlets. </maml:para> </maml:description> <command:syntax><command:syntaxItem><maml:name>Connect-AzureAD</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"><maml:name>AadAccessToken</maml:name> <maml:Description><maml:para>指定 Azure Active Directory Graph 存取權杖。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type><maml:name>String</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"><maml:name>AccountId</maml:name> <maml:Description><maml:para>指定帳戶的識別碼。以使用者存取權杖進行驗證時,必須指定使用者的 UPN。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type><maml:name>String</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"><maml:name>AzureEnvironmentName</maml:name> <maml:Description><maml:para>指定 Azure 環境名稱。此參數可接受的值為: </maml:para> <maml:para>- AzureCloud </maml:para> <maml:para>- AzureChinaCloud </maml:para> <maml:para>- AzureUSGovernment </maml:para> <maml:para>- AzureGermanyCloud </maml:para> <maml:para> </maml:para> <maml:para>預設值為 AzureCloud。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">EnvironmentName</command:parameterValue> <dev:type><maml:name>EnvironmentName</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="infa"><maml:name>InformationAction</maml:name> <maml:Description><maml:para>指定此 Cmdlet 回應資訊事件的方式。此參數可接受的值: </maml:para> <maml:para>- 繼續 </maml:para> <maml:para>- 略過 </maml:para> <maml:para>- 查詢 </maml:para> <maml:para>- SilentlyContinue </maml:para> <maml:para>- 停止 </maml:para> <maml:para>- 暫止 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">ActionPreference</command:parameterValue> <dev:type><maml:name>ActionPreference</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="iv"><maml:name>InformationVariable</maml:name> <maml:Description><maml:para>指定要用於儲存資訊事件訊息的變數。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type><maml:name>String</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"><maml:name>LogLevel</maml:name> <maml:Description><maml:para>指定記錄層級。此參數可接受的值為: </maml:para> <maml:para>- 資訊 </maml:para> <maml:para>- 錯誤 </maml:para> <maml:para>- 警告 </maml:para> <maml:para>- 無 </maml:para> <maml:para> </maml:para> <maml:para>預設值為「資訊」。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">LogLevel</command:parameterValue> <dev:type><maml:name>LogLevel</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"><maml:name>MsAccessToken</maml:name> <maml:Description><maml:para>指定 Microsoft Graph 存取權杖。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type><maml:name>String</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="Domain"><maml:name>TenantId</maml:name> <maml:Description><maml:para>指定租用戶的識別碼。 </maml:para> <maml:para>若未指定此參數,即會使用主租用戶驗證該帳戶。 </maml:para> <maml:para>您必須指定 TenantId 參數來驗證為服務主體,或是使用 Microsoft 帳戶時,必須指定 TenantId 參數。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type><maml:name>String</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="cf"><maml:name>Confirm</maml:name> <maml:Description><maml:para>執行 Cmdlet 前提示您確認。 </maml:para> </maml:Description> <dev:type><maml:name>SwitchParameter</maml:name> <maml:uri/></dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="wi"><maml:name>WhatIf</maml:name> <maml:Description><maml:para>顯示執行此 Cmdlet 時會發生的狀況。此 Cmdlet 並未執行。 </maml:para> </maml:Description> <dev:type><maml:name>SwitchParameter</maml:name> <maml:uri/></dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem><maml:name>Connect-AzureAD</maml:name> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"><maml:name>ApplicationId</maml:name> <maml:Description><maml:para>指定服務主體的應用程式識別碼。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type><maml:name>String</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"><maml:name>AzureEnvironmentName</maml:name> <maml:Description><maml:para>指定 Azure 環境名稱。此參數可接受的值為: </maml:para> <maml:para>- AzureCloud </maml:para> <maml:para>- AzureChinaCloud </maml:para> <maml:para>- AzureUSGovernment </maml:para> <maml:para>- AzureGermanyCloud </maml:para> <maml:para> </maml:para> <maml:para>預設值為 AzureCloud。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">EnvironmentName</command:parameterValue> <dev:type><maml:name>EnvironmentName</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"><maml:name>CertificateThumbprint</maml:name> <maml:Description><maml:para>指定有權執行此動作的使用者帳戶之數位公開金鑰 X.509 憑證的憑證指紋。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type><maml:name>String</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="infa"><maml:name>InformationAction</maml:name> <maml:Description><maml:para>指定此 Cmdlet 回應資訊事件的方式。此參數可接受的值: </maml:para> <maml:para>- 繼續 </maml:para> <maml:para>- 略過 </maml:para> <maml:para>- 查詢 </maml:para> <maml:para>- SilentlyContinue </maml:para> <maml:para>- 停止 </maml:para> <maml:para>- 暫止 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">ActionPreference</command:parameterValue> <dev:type><maml:name>ActionPreference</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="iv"><maml:name>InformationVariable</maml:name> <maml:Description><maml:para>指定要用於儲存資訊事件訊息的變數。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type><maml:name>String</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"><maml:name>LogLevel</maml:name> <maml:Description><maml:para>指定記錄層級。此參數可接受的值為: </maml:para> <maml:para>- 資訊 </maml:para> <maml:para>- 錯誤 </maml:para> <maml:para>- 警告 </maml:para> <maml:para>- 無 </maml:para> <maml:para> </maml:para> <maml:para>預設值為「資訊」。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">LogLevel</command:parameterValue> <dev:type><maml:name>LogLevel</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="Domain"><maml:name>TenantId</maml:name> <maml:Description><maml:para>指定租用戶的識別碼。 </maml:para> <maml:para>若未指定此參數,即會使用主租用戶驗證該帳戶。 </maml:para> <maml:para>您必須指定 TenantId 參數來驗證為服務主體,或是使用 Microsoft 帳戶時,必須指定 TenantId 參數。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type><maml:name>String</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="cf"><maml:name>Confirm</maml:name> <maml:Description><maml:para>執行 Cmdlet 前提示您確認。 </maml:para> </maml:Description> <dev:type><maml:name>SwitchParameter</maml:name> <maml:uri/></dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="wi"><maml:name>WhatIf</maml:name> <maml:Description><maml:para>顯示執行此 Cmdlet 時會發生的狀況。此 Cmdlet 並未執行。 </maml:para> </maml:Description> <dev:type><maml:name>SwitchParameter</maml:name> <maml:uri/></dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> <command:syntaxItem><maml:name>Connect-AzureAD</maml:name> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"><maml:name>AzureEnvironmentName</maml:name> <maml:Description><maml:para>指定 Azure 環境名稱。此參數可接受的值為: </maml:para> <maml:para>- AzureCloud </maml:para> <maml:para>- AzureChinaCloud </maml:para> <maml:para>- AzureUSGovernment </maml:para> <maml:para>- AzureGermanyCloud </maml:para> <maml:para> </maml:para> <maml:para>預設值為 AzureCloud。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">EnvironmentName</command:parameterValue> <dev:type><maml:name>EnvironmentName</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"><maml:name>Credential</maml:name> <maml:Description><maml:para>指定 PSCredential 物件。如需 PSCredential 物件的詳細資訊,請輸入 Get-Help Get-Credential。 </maml:para> <maml:para>PSCredential 物件可為組織識別碼認證,提供使用者識別碼及密碼。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">PSCredential</command:parameterValue> <dev:type><maml:name>PSCredential</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="infa"><maml:name>InformationAction</maml:name> <maml:Description><maml:para>指定此 Cmdlet 回應資訊事件的方式。此參數可接受的值: </maml:para> <maml:para>- 繼續 </maml:para> <maml:para>- 略過 </maml:para> <maml:para>- 查詢 </maml:para> <maml:para>- SilentlyContinue </maml:para> <maml:para>- 停止 </maml:para> <maml:para>- 暫止 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">ActionPreference</command:parameterValue> <dev:type><maml:name>ActionPreference</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="iv"><maml:name>InformationVariable</maml:name> <maml:Description><maml:para>指定要用於儲存資訊事件訊息的變數。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type><maml:name>String</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"><maml:name>LogLevel</maml:name> <maml:Description><maml:para>指定記錄層級。此參數可接受的值為: </maml:para> <maml:para>- 資訊 </maml:para> <maml:para>- 錯誤 </maml:para> <maml:para>- 警告 </maml:para> <maml:para>- 無 </maml:para> <maml:para> </maml:para> <maml:para>預設值為「資訊」。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">LogLevel</command:parameterValue> <dev:type><maml:name>LogLevel</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="Domain"><maml:name>TenantId</maml:name> <maml:Description><maml:para>指定租用戶的識別碼。 </maml:para> <maml:para>若未指定此參數,即會使用主租用戶驗證該帳戶。 </maml:para> <maml:para>您必須指定 TenantId 參數來驗證為服務主體,或是使用 Microsoft 帳戶時,必須指定 TenantId 參數。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type><maml:name>String</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="cf"><maml:name>Confirm</maml:name> <maml:Description><maml:para>執行 Cmdlet 前提示您確認。 </maml:para> </maml:Description> <dev:type><maml:name>SwitchParameter</maml:name> <maml:uri/></dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="wi"><maml:name>WhatIf</maml:name> <maml:Description><maml:para>顯示執行此 Cmdlet 時會發生的狀況。此 Cmdlet 並未執行。 </maml:para> </maml:Description> <dev:type><maml:name>SwitchParameter</maml:name> <maml:uri/></dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters><command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"><maml:name>AadAccessToken</maml:name> <maml:Description><maml:para>指定 Azure Active Directory Graph 存取權杖。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type><maml:name>String</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"><maml:name>AccountId</maml:name> <maml:Description><maml:para>指定帳戶的識別碼。以使用者存取權杖進行驗證時,必須指定使用者的 UPN。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type><maml:name>String</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"><maml:name>ApplicationId</maml:name> <maml:Description><maml:para>指定服務主體的應用程式識別碼。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type><maml:name>String</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"><maml:name>AzureEnvironmentName</maml:name> <maml:Description><maml:para>指定 Azure 環境名稱。此參數可接受的值為: </maml:para> <maml:para>- AzureCloud </maml:para> <maml:para>- AzureChinaCloud </maml:para> <maml:para>- AzureUSGovernment </maml:para> <maml:para>- AzureGermanyCloud </maml:para> <maml:para> </maml:para> <maml:para>預設值為 AzureCloud。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">EnvironmentName</command:parameterValue> <dev:type><maml:name>EnvironmentName</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="true" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"><maml:name>CertificateThumbprint</maml:name> <maml:Description><maml:para>指定有權執行此動作的使用者帳戶之數位公開金鑰 X.509 憑證的憑證指紋。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type><maml:name>String</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"><maml:name>Credential</maml:name> <maml:Description><maml:para>指定 PSCredential 物件。如需 PSCredential 物件的詳細資訊,請輸入 Get-Help Get-Credential。 </maml:para> <maml:para>PSCredential 物件可為組織識別碼認證,提供使用者識別碼及密碼。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">PSCredential</command:parameterValue> <dev:type><maml:name>PSCredential</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="infa"><maml:name>InformationAction</maml:name> <maml:Description><maml:para>指定此 Cmdlet 回應資訊事件的方式。此參數可接受的值: </maml:para> <maml:para>- 繼續 </maml:para> <maml:para>- 略過 </maml:para> <maml:para>- 查詢 </maml:para> <maml:para>- SilentlyContinue </maml:para> <maml:para>- 停止 </maml:para> <maml:para>- 暫止 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">ActionPreference</command:parameterValue> <dev:type><maml:name>ActionPreference</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="iv"><maml:name>InformationVariable</maml:name> <maml:Description><maml:para>指定要用於儲存資訊事件訊息的變數。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type><maml:name>String</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"><maml:name>LogLevel</maml:name> <maml:Description><maml:para>指定記錄層級。此參數可接受的值為: </maml:para> <maml:para>- 資訊 </maml:para> <maml:para>- 錯誤 </maml:para> <maml:para>- 警告 </maml:para> <maml:para>- 無 </maml:para> <maml:para> </maml:para> <maml:para>預設值為「資訊」。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">LogLevel</command:parameterValue> <dev:type><maml:name>LogLevel</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="none"><maml:name>MsAccessToken</maml:name> <maml:Description><maml:para>指定 Microsoft Graph 存取權杖。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type><maml:name>String</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="Domain"><maml:name>TenantId</maml:name> <maml:Description><maml:para>指定租用戶的識別碼。 </maml:para> <maml:para>若未指定此參數,即會使用主租用戶驗證該帳戶。 </maml:para> <maml:para>您必須指定 TenantId 參數來驗證為服務主體,或是使用 Microsoft 帳戶時,必須指定 TenantId 參數。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type><maml:name>String</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="cf"><maml:name>Confirm</maml:name> <maml:Description><maml:para>執行 Cmdlet 前提示您確認。 </maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type><maml:name>SwitchParameter</maml:name> <maml:uri/></dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="wi"><maml:name>WhatIf</maml:name> <maml:Description><maml:para>顯示執行此 Cmdlet 時會發生的狀況。此 Cmdlet 並未執行。 </maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type><maml:name>SwitchParameter</maml:name> <maml:uri/></dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes></command:inputTypes> <command:returnValues></command:returnValues> <maml:alertSet><maml:alert><maml:para> </maml:para> </maml:alert> </maml:alertSet> <command:examples><command:example><maml:title>Example 1: Connect a PowerShell session to a tenant</maml:title> <dev:code>PS C:\> Connect-AzureAD -Confirm</dev:code> <dev:remarks><maml:para>This command connects the current PowerShell session to an Azure Active Directory tenant. The command prompts you for a username and password for the tenant you want to connect to. The Confirm parameter prompts you for confirmation. </maml:para> <maml:para>If multi-factor authentication is enabled for your credentials, you must log in using the interactive option or use service principal authentication. </maml:para> </dev:remarks> </command:example> <command:example><maml:title>Example 2: Connect a session using a variable</maml:title> <dev:code>PS C:\> $Credential = Get-Credential PS C:\> Connect-AzureAD -Credential $Credential</dev:code> <dev:remarks><maml:para>The first command gets the user credentials, and then stores them in the $Credential variable. </maml:para> <maml:para>The second command connects the current PowerShell session using the credentials in $Credential. </maml:para> <maml:para>This account authenticates with Azure Active Directory using organizational ID credentials. You cannot use multi-factor authentication or Microsoft account credentials to run Azure Active Directory cmdlets with this account. </maml:para> </dev:remarks> </command:example> <command:example><maml:title>Example 3: Connect a session as a service principal</maml:title> <dev:code># Login to Azure AD PowerShell With Admin Account Connect-AzureAD # Create the self signed cert $currentDate = Get-Date $endDate = $currentDate.AddYears(1) $notAfter = $endDate.AddYears(1) $pwd = "<password>" $thumb = (New-SelfSignedCertificate -CertStoreLocation cert:\localmachine\my -DnsName com.foo.bar -KeyExportPolicy Exportable -Provider "Microsoft Enhanced RSA and AES Cryptographic Provider" -NotAfter $notAfter).Thumbprint $pwd = ConvertTo-SecureString -String $pwd -Force -AsPlainText Export-PfxCertificate -cert "cert:\localmachine\my\$thumb" -FilePath c:\temp\examplecert.pfx -Password $pwd # Load the certificate $cert = New-Object System.Security.Cryptography.X509Certificates.X509Certificate("C:\temp\examplecert.pfx", $pwd) $keyValue = [System.Convert]::ToBase64String($cert.GetRawCertData()) # Create the Azure Active Directory Application $application = New-AzureADApplication -DisplayName "test123" -IdentifierUris "https://test123" New-AzureADApplicationKeyCredential -ObjectId $application.ObjectId -CustomKeyIdentifier "Test123" -StartDate $currentDate -EndDate $endDate -Type AsymmetricX509Cert -Usage Verify -Value $keyValue # Create the Service Principal and connect it to the Application $sp=New-AzureADServicePrincipal -AppId $application.AppId # Give the Service Principal Reader access to the current tenant (Get-AzureADDirectoryRole) Add-AzureADDirectoryRoleMember -ObjectId 5997d714-c3b5-4d5b-9973-ec2f38fd49d5 -RefObjectId $sp.ObjectId # Get Tenant Detail $tenant=Get-AzureADTenantDetail # Now you can login to Azure PowerShell with your Service Principal and Certificate Connect-AzureAD -TenantId $tenant.ObjectId -ApplicationId $sp.AppId -CertificateThumbprint $thumb</dev:code> <dev:remarks><maml:para>This command authenticates the user to Azure Active Directory as a service principal. </maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks><maml:navigationLink><maml:linkText>Disconnet-AzureAD</maml:linkText> <maml:uri></maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> <command:command xmlns:maml="http://schemas.microsoft.com/maml/2004/10" xmlns:command="http://schemas.microsoft.com/maml/dev/command/2004/10" xmlns:dev="http://schemas.microsoft.com/maml/dev/2004/10" xmlns:MSHelp="http://msdn.microsoft.com/mshelp"> <command:details><command:name>Disconnect-AzureAD</command:name> <command:verb>Disconnect</command:verb> <command:noun>AzureAD</command:noun> <maml:description><maml:para>Disconnects the current session from an Azure Active Directory tenant. </maml:para> </maml:description> </command:details> <maml:description><maml:para>The Disconnect-AzureAD cmdlet disconnects the current session from an Azure Active Directory tenant. </maml:para> </maml:description> <command:syntax><command:syntaxItem><maml:name>Disconnect-AzureAD</maml:name> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="infa"><maml:name>InformationAction</maml:name> <maml:Description><maml:para>指定此 Cmdlet 回應資訊事件的方式。此參數可接受的值: </maml:para> <maml:para>- 繼續 </maml:para> <maml:para>- 略過 </maml:para> <maml:para>- 查詢 </maml:para> <maml:para>- SilentlyContinue </maml:para> <maml:para>- 停止 </maml:para> <maml:para>- 暫止 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">ActionPreference</command:parameterValue> <dev:type><maml:name>ActionPreference</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="iv"><maml:name>InformationVariable</maml:name> <maml:Description><maml:para>指定要用於儲存資訊事件訊息的變數。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type><maml:name>String</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="cf"><maml:name>Confirm</maml:name> <maml:Description><maml:para>執行 Cmdlet 前提示您確認。執行 Cmdlet 前提示您確認。 </maml:para> </maml:Description> <dev:type><maml:name>SwitchParameter</maml:name> <maml:uri/></dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="wi"><maml:name>WhatIf</maml:name> <maml:Description><maml:para>顯示執行此 Cmdlet 時會發生的狀況。此 Cmdlet 並未執行。顯示執行此 Cmdlet 時會發生的狀況。此 Cmdlet 並未執行。 </maml:para> </maml:Description> <dev:type><maml:name>SwitchParameter</maml:name> <maml:uri/></dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters><command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="infa"><maml:name>InformationAction</maml:name> <maml:Description><maml:para>指定此 Cmdlet 回應資訊事件的方式。此參數可接受的值: </maml:para> <maml:para>- 繼續 </maml:para> <maml:para>- 略過 </maml:para> <maml:para>- 查詢 </maml:para> <maml:para>- SilentlyContinue </maml:para> <maml:para>- 停止 </maml:para> <maml:para>- 暫止 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">ActionPreference</command:parameterValue> <dev:type><maml:name>ActionPreference</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="iv"><maml:name>InformationVariable</maml:name> <maml:Description><maml:para>指定要用於儲存資訊事件訊息的變數。 </maml:para> </maml:Description> <command:parameterValue required="true" variableLength="false">String</command:parameterValue> <dev:type><maml:name>String</maml:name> <maml:uri/></dev:type> <dev:defaultValue>None</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="cf"><maml:name>Confirm</maml:name> <maml:Description><maml:para>執行 Cmdlet 前提示您確認。執行 Cmdlet 前提示您確認。 </maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type><maml:name>SwitchParameter</maml:name> <maml:uri/></dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <command:parameter required="false" variableLength="true" globbing="false" pipelineInput="False" position="named" aliases="wi"><maml:name>WhatIf</maml:name> <maml:Description><maml:para>顯示執行此 Cmdlet 時會發生的狀況。此 Cmdlet 並未執行。顯示執行此 Cmdlet 時會發生的狀況。此 Cmdlet 並未執行。 </maml:para> </maml:Description> <command:parameterValue required="false" variableLength="false">SwitchParameter</command:parameterValue> <dev:type><maml:name>SwitchParameter</maml:name> <maml:uri/></dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:parameters> <command:inputTypes></command:inputTypes> <command:returnValues></command:returnValues> <maml:alertSet><maml:alert><maml:para> </maml:para> </maml:alert> </maml:alertSet> <command:examples><command:example><maml:title>Example 1: Disconnect your session from a tenant</maml:title> <dev:code>PS C:\> Disconnect-AzureAD</dev:code> <dev:remarks><maml:para>This command disconnects your session from a tenant. </maml:para> </dev:remarks> </command:example> </command:examples> <command:relatedLinks><maml:navigationLink><maml:linkText>Connect-AzureAD</maml:linkText> <maml:uri></maml:uri> </maml:navigationLink> </command:relatedLinks> </command:command> </helpItems> |