New-AipServiceRightsDefinition

參考

模組:: AIPService

為 Azure 資訊保護的保護範本建立許可權定義物件。

Syntax

New-AipServiceRightsDefinition
   [-EmailAddress <String>]
   [-DomainName <String>]
   -Rights <System.Collections.Generic.List`1[System.String]>
   [<CommonParameters>]

Description

當您使用Add-AipServiceTemplate 或 Set-AipServiceTemplateProperty Cmdlet 時，New-AipServiceRightsDefinition Cmdlet 會建立您儲存為變數的許可權定義物件，然後使用來建立或更新 Azure 資訊保護的保護範本。

許可權定義物件表示使用者對 Azure 資訊保護所保護內容的許可權。您可以指定組織中的使用者、群組或所有使用者。

當您在Azure 入口網站中建立或設定保護範本時，也可以進行類似的設定，但此 Cmdlet 提供更精細的控制。不過，此 Cmdlet 不支援您可以在Azure 入口網站中選取的任何已驗證使用者選項。

提示：您可以在此 Cmdlet 在 Azure Active Directory 中具有使用者帳戶並Office 365時，啟用與其他組織的安全共同作業。例如，提供外部群組 VIEW 和 DOCEDIT 許可權，以便在聯合專案上共同作業。或者，為合作夥伴組織中的所有使用者提供 VIEW 許可權。

如需保護範本的詳細資訊，包括如何在Azure 入口網站中設定範本，請參閱設定和管理 Azure 資訊保護的範本。

使用 Azure 資訊保護統一標籤用戶端？

Azure 資訊保護統一標籤用戶端會間接使用保護範本。如果您有統一標籤用戶端，建議您使用以標籤為基礎的 Cmdlet，而不是直接修改您的保護範本。

如需詳細資訊，請參閱 Microsoft 365 檔中的建立和發佈敏感度標籤。

範例

範例 1：為使用者建立許可權定義物件

PS C:\>$R1 = New-AipServiceRightsDefinition -EmailAddress "ElisaDaugherty@Contoso.com" -Rights "VIEW","DOCEDIT"

此命令會為指定的使用者建立許可權定義物件，並將此原則儲存在名為 R1 的變數中，然後可用來建立或更新保護範本。

此命令包含 Contoso 組織中使用者的許可權 VIEW 和 DOCEDIT。

範例 2：為所有使用者建立許可權定義物件

PS C:\>$R2 = New-AipServiceRightsDefinition -DomainName "Contoso.com" -Rights "VIEW"

此命令會建立 Contoso 組織的許可權定義物件，並將此原則儲存在名為 R2 的變數中，然後可用來建立或更新保護範本。此命令包含 Contoso 組織中所有使用者的 VIEW 許可權。

範例 3：為「Just for me」組態建立許可權定義物件

PS C:\>$R3 = New-AipServiceRightsDefinition -EmailAddress "IPC_USER_ID_OWNER" -Rights "OWNER"

此命令會建立套用保護的許可權定義物件，如此一來，只有套用保護的人員才能開啟檔或電子郵件，且沒有任何限制。此設定有時稱為「僅供我使用」，而且可能是必要的結果，讓使用者可以將檔案儲存到任何位置，並確保只能開啟檔案。因為只有套用保護的人員可以開啟內容，所以此設定不適用於需要共同作業的內容。

參數

-DomainName

指定組織或其他組織的功能變數名稱，以用於建立或更新保護範本時授與許可權。當組織有多個網域時，您指定的功能變數名稱並不重要;系統會自動包含來自該組織所有已驗證網域的使用者。

只為組織中的所有使用者指定一個功能變數名稱;若要授與多個組織的許可權，請建立另一個許可權定義物件。

請注意，若要讓 Azure AD 驗證成功，使用者必須在 Azure Active Directory 中擁有帳戶。 Office 365使用者在 Azure Active Directory 中自動擁有帳戶。

您可以指定來自社交提供者的功能變數名稱 (，例如 gmail.com) ，但僅支援 Azure AD 中帳戶的驗證，以及針對Office 365訊息加密的新功能設定Exchange Online時。

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

-EmailAddress

指定使用者或群組的電子郵件地址。使用者或群組可以是組織內部或外部使用者。若要讓 Azure AD 驗證成功，使用者必須在 Azure Active Directory 中擁有帳戶。 Office 365使用者在 Azure Active Directory 中自動擁有帳戶。

其他驗證方法包括來自社交提供者的電子郵件地址 (例如，當Exchange Online設定為Office 365郵件加密的新功能時，Gmail 帳戶) 。有些應用程式也支援使用 Microsoft 帳戶的個人電子郵件地址。如需使用 Microsoft 帳戶進行驗證的詳細資訊，請參閱支援的案例資料表。

Cmdlet 會將 Rights 參數所指定的許可權與位址所指定的使用者或群組產生關聯。

提示：如果您想要指定組織中的所有使用者或另一個組織中的所有使用者，請使用 DomainName 參數。

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

-Rights

指定權限清單。清單中包含下列一或多個動作：

視圖： 由大部分應用程式解譯為允許在螢幕上呈現資料。
編輯： 由大部分應用程式解譯為允許修改檔中的內容，並加以儲存。
DOCEDIT： 由大部分應用程式解譯為允許修改檔的內容。
提取： 由大部分應用程式解譯為允許將內容複寫到剪貼簿，或以未加密的形式擷取內容。
OBJMODEL： 由大部分應用程式解譯為允許以程式設計方式存取檔;例如，使用宏。
出口： 由大部分應用程式解譯為允許以未加密形式儲存檔案。例如，此許可權可讓您以不支援保護的不同檔案格式儲存。
列印： 由大部分應用程式解譯為允許列印檔案。
擁有者： 使用者具有檔的擁有權限，包括移除保護的能力。
向前： 由大部分應用程式解譯為允許轉寄電子郵件訊息，以及將收件者新增至 [收件者] 和 [副本] 行。
答覆： 由大部分應用程式解譯為允許選取回復電子郵件訊息，而不允許變更 [收件者] 或 [副本] 行。
REPLYALL： 由大部分應用程式解譯為允許回復電子郵件訊息的所有收件者，但不允許使用者將收件者新增至 [收件者] 或 [副本] 行。

注意：為了清楚起見，模組中的檔和顯示文字會將這些許可權顯示為全部大寫字母。但這些值並不區分大小寫，用大寫或小寫來指定皆可。

如需許可權的詳細資訊，請參閱設定 Azure 資訊保護的許可權。

Type:	System.Collections.Generic.List`1[System.String]
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False