CreateManagedFolder 操作CreateManagedFolder operation

CreateManagedFolder 操作は、Exchange ストアに管理フォルダーを作成します。The CreateManagedFolder operation creates a managed folder in the Exchange store.

CreateManagedFolder 操作の使用Using the CreateManagedFolder Operation

CreateManagedFolder 操作は、管理されたカスタムフォルダーをユーザーのメールボックスに追加します。The CreateManagedFolder operation adds a managed custom folder to a user's mailbox. Exchange 管理シェルのGet-ManagedFolderコマンドレットを使用して、追加できる利用可能な管理フォルダーを見つけることができます。You can use the Exchange Management Shell Get-ManagedFolder cmdlet to find available managed folders to add. このコマンドレットは、管理されたカスタムフォルダーと管理された既定のフォルダーの両方を返しますが、管理されたカスタムフォルダーのみを追加できます。Although this cmdlet returns both managed custom folders and managed default folders, only managed custom folders can be added. 管理されたカスタムフォルダーは、ManagedCustomFolder フォルダーの種類によって識別されます。Managed custom folders are identified by the ManagedCustomFolder folder type. System.directoryservices 名前空間には、使用可能な管理フォルダーの名前を検出するために使用できる型も含まれています。The System.DirectoryServices namespace also includes types that can be used to discover the names of available managed folders.

注意

Exchange Web サービスを使用して、メールボックスに追加する使用可能な管理フォルダーの名前を検索することはできません。You cannot use Exchange Web Services to find the names of available managed folders to add to a mailbox.

FindFolder および GetFolder 操作を使用して、管理フォルダーにアクセスできます。You can use the FindFolder and GetFolder operations to access managed folders. FindFolder は、指定された親フォルダー内のフォルダーを検索するために使用されます。FindFolder is used to search for folders in a specified parent folder. これは、同じディレクトリに重複した管理されたカスタムフォルダーを追加しようとする前に、フォルダーで管理フォルダーを検出できるようにするために使用できます。This can be used so that managed folders can be discovered in a folder before trying to add a duplicate managed custom folder to the same directory. GetFolder は、FindFolder 操作の後に使用され、管理されたカスタムフォルダーに関する詳細情報を取得します。GetFolder is used after the FindFolder operation to get more information about a managed custom folder.

注釈Remarks

メッセージングレコード管理 (MRM) ポリシーを設定する方法については、「 how To Create a Managed Folder Mailbox policy」を参照してください。For information about how to set up messaging records management (MRM) policy, see How to Create a Managed Folder Mailbox Policy.

管理されたカスタムフォルダーをメールボックスから削除する方法については、「削除-ManagedFolder」を参照してください。For information about how to remove managed custom folders from a mailbox, see Remove-ManagedFolder.

CreateManagedFolder 要求の例CreateManagedFolder request example

DescriptionDescription

次の CreateManagedFolder 要求の例は、Test 管理フォルダーという名前の管理フォルダーをメールボックスに追加する方法を示しています。The following example of a CreateManagedFolder request shows how to add a managed folder named Test Managed Folder to a mailbox.

注意

代理人アクセスを使用して、管理されたカスタムフォルダーを追加することもできます。You can also use delegate access to add managed custom folders.

コードCode

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <CreateManagedFolder xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <FolderNames>
        <t:FolderName>Test Managed Folder</t:FolderName>
      </FolderNames>
    </CreateManagedFolder>
  </soap:Body>
</soap:Envelope>

Request 要素Request elements

要求では、次の要素が使用されます。The following elements are used in the request:

CreateManagedFolder 操作の要求メッセージに関するその他のオプションについては、スキーマ階層を参照してください。To find other options for the request message of the CreateManagedFolder operation, explore the schema hierarchy. CreateManagedFolder要素から開始します。Start at the CreateManagedFolder element.

成功した CreateManagedFolder 応答Successful CreateManagedFolder Response

DescriptionDescription

次のコード例は、CreateManagedFolder 要求に対する正常な応答を示しています。The following code example shows a successful response to a CreateManagedFolder request.

注意

Idおよびchangekey属性の値は、読みやすくするために短縮されています。The Id and ChangeKey attribute values have been shortened to preserve readability.

コードCode

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header>
    <t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="598" MinorBuildNumber="0" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"/>
  </soap:Header>
  <soap:Body>
    <CreateManagedFolderResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                                 xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                                 xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:CreateManagedFolderResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:Folders>
            <t:Folder>
              <t:FolderId Id="AS0AdX=" ChangeKey="AACADA=="/>
            </t:Folder>
          </m:Folders>
        </m:CreateManagedFolderResponseMessage>
      </m:ResponseMessages>
    </CreateManagedFolderResponse>
  </soap:Body>
</soap:Envelope>

成功した応答要素Successful response elements

応答では、次の要素が使用されます。The following elements are used in the response:

CreateManagedFolder 操作の応答メッセージに関するその他のオプションについては、スキーマ階層を参照してください。To find other options for the response messages of the CreateManagedFolder operation, explore the schema hierarchy. CreateManagedFolderResponse要素から開始します。Start at the CreateManagedFolderResponse element.

CreateManagedFolder エラー応答CreateManagedFolder error response

DescriptionDescription

次のコード例は、CreateManagedFolder 要求に対するエラー応答を示しています。The following code example shows an error response to a CreateManagedFolder request.

コードCode

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header>
    <t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="598" MinorBuildNumber="0" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"/>
  </soap:Header>
  <soap:Body>
    <CreateManagedFolderResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                                 xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                                 xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:CreateManagedFolderResponseMessage ResponseClass="Error">
          <m:MessageText>A specified managed folder already exists in the mailbox.</m:MessageText>
          <m:ResponseCode>ErrorManagedFolderAlreadyExists</m:ResponseCode>
          <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
          <m:Folders/>
        </m:CreateManagedFolderResponseMessage>
      </m:ResponseMessages>
    </CreateManagedFolderResponse>
  </soap:Body>
</soap:Envelope>

エラー応答要素Error response elements

エラー応答では、次の要素が使用されます。The following elements are used in the error response:

関連項目See also

GetFolder 操作GetFolder operation

FindFolder 操作FindFolder operation

フォルダーの検索Finding Folders

管理フォルダーの追加Adding Managed Folders