Delegate365.dll-Help.xml
|
<?xml version="1.0" encoding="utf-8"?>
<helpItems schema="maml" xmlns="http://msh"> <!-- Cmdlet: Get-DAADUser --> <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"> <command:details> <command:name>Get-DAADUser</command:name> <command:verb>Get</command:verb> <command:noun>DAADUser</command:noun> <maml:description> <maml:para>Gets one or multiple users from Azure Active Directory.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Get-DAADUser returns a list of users from Azure Active Directory. This command allows to directly query the AAD, without any filtering. Therefore, the runtime can be longer than other cmdlets that deliver data from Delegate365. Parameters allow to get all users or a specific user. By default, the first 100 users are returned. Use the -All parameter to get the full list of users. Filter for one user by using the -Identity Parameter and the full UserPrincipalName or the ID. The ouput delivers all user properties from AAD.</maml:para> <maml:para>Important: By default, the command shows all users that are assigned to any OU in Delegate365. When using the -Unassigned parameter, all users are returned that are not assigned to an OU. Be aware that this parameter only delivers the unassigned users if the authenticated user is PowerShell Administrator. Scope Admins that are not PowerShell Administrator will see no output (an empty list), while PowerShell Administrators get all the unassigned users.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Get-DAADUser</maml:name> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all users (and not only the first 100 users).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific user. Wildcards are not supported, use the full UserPrincipalName or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Filter by the name of an OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: UnAssigned --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnAssigned</maml:name> <maml:description> <maml:para>Delivers all users from AAD that are not assigned to an OU. Requires the PowerShell Administration permission.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: UnAssigned --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnAssigned</maml:name> <maml:description> <maml:para>Delivers all users from AAD that are not assigned to an OU. Requires the PowerShell Administration permission.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all users (and not only the first 100 users).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific user. Wildcards are not supported, use the full UserPrincipalName or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Filter by the name of an OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: AadUser[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.AadUser[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Get-DAADUser</dev:code> <dev:remarks> <maml:para>By default, the command returns the first 100 assigned users.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Get-DAADUser -All</dev:code> <dev:remarks> <maml:para>Add -All to get all users.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 3 ----------</maml:title> <dev:code>Get-DAADUser -Unassigned -All</dev:code> <dev:remarks> <maml:para>Add -Unassigned to get users that are NOT assigned to an OU (can be combined with -All).</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 4 ----------</maml:title> <dev:code>Get-DAADUser -OU Seattle</dev:code> <dev:remarks> <maml:para>Add -OU to get users that are assigned to a specific OU.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 5 ----------</maml:title> <dev:code>Get-DAADUser -Identity john.doe@delegate365.com</dev:code> <dev:remarks> <maml:para>Get one specific user by UPN or by ID,</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Get-DAdministrator --> <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"> <command:details> <command:name>Get-DAdministrator</command:name> <command:verb>Get</command:verb> <command:noun>DAdministrator</command:noun> <maml:description> <maml:para>Gets one or multiple administrators from Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Get-DAdministrator returns a list of administrators from Delegate365. To use Delegate365, a user must be added as Administrator in the Administrator's list. Permissions and assignments to OU's and to domains define the scope for an administrator. Parameters allow to get all administrators or one specific administrator. Filter for one administrator by using the -Identity Parameter and the full UserPrincipalName or the ID. The output shows assigned policies and settings for each admin.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Get-DAdministrator</maml:name> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all items (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific item. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all items (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific item. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: Administrator[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.Administrator[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Get-DAdministrator</dev:code> <dev:remarks> <maml:para>By default, the command returns the first 100 assigned admins.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Get-DAdministrator -All</dev:code> <dev:remarks> <maml:para>Add -All to get all admins.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 3 ----------</maml:title> <dev:code>Get-DAdministrator -Identity john.doe@delegate365.com</dev:code> <dev:remarks> <maml:para>Get one specific admin by UPN or by ID.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: New-DAdministrator --> <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"> <command:details> <command:name>New-DAdministrator</command:name> <command:verb>New</command:verb> <command:noun>DAdministrator</command:noun> <maml:description> <maml:para>Creates a new administrator in Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>New-DAdministrator creates a new administrator in Delegate365. To use Delegate365, a user must be added as Administrator in the Administrator's list. Permissions and assignments to OU's and to domains define the scope for an administrator. Administrators can be users in the same Office 365 tenant, or can be external users with an Office 365 work account. Optional, additional properties can be handed over to the command, see the example. The output shows the created admin object.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>New-DAdministrator</maml:name> <!-- Parameter: UserPrincipalName --> <command:parameter required="true" globbing="false" pipelineInput="false" position="2"> <maml:name>UserPrincipalName</maml:name> <maml:description> <maml:para>UserPrincipalName is the login name of the new admin and is required.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OrganizationalUnits --> <command:parameter required="false" globbing="false" pipelineInput="false" position="3"> <maml:name>OrganizationalUnits</maml:name> <maml:description> <maml:para>OrganizationalUnits can be a string array, that can be separated by comma, e.g. 'Paris', 'New York'.</maml:para> </maml:description> <command:parameterValue required="true">string[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Domains --> <command:parameter required="false" globbing="false" pipelineInput="false" position="4"> <maml:name>Domains</maml:name> <maml:description> <maml:para>Domains can be a string array, that can be separated by comma, e.g. 'atwork-it.com', 'delegate365.com'.</maml:para> </maml:description> <command:parameterValue required="true">string[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Settings --> <command:parameter required="false" globbing="false" pipelineInput="false" position="5"> <maml:name>Settings</maml:name> <maml:description> <maml:para>Settings allow to set the notification email, phone number and other settings for the admin.</maml:para> </maml:description> <command:parameterValue required="true">AdministratorSettings</command:parameterValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.AdministratorSettings</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: D365Permission --> <command:parameter required="false" globbing="false" pipelineInput="false" position="6"> <maml:name>D365Permission</maml:name> <maml:description> <maml:para>D365Permission define the name of the permission policy that shall be assigned.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: UserPrincipalName --> <command:parameter required="true" globbing="false" pipelineInput="false" position="2"> <maml:name>UserPrincipalName</maml:name> <maml:description> <maml:para>UserPrincipalName is the login name of the new admin and is required.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OrganizationalUnits --> <command:parameter required="false" globbing="false" pipelineInput="false" position="3"> <maml:name>OrganizationalUnits</maml:name> <maml:description> <maml:para>OrganizationalUnits can be a string array, that can be separated by comma, e.g. 'Paris', 'New York'.</maml:para> </maml:description> <command:parameterValue required="true">string[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Domains --> <command:parameter required="false" globbing="false" pipelineInput="false" position="4"> <maml:name>Domains</maml:name> <maml:description> <maml:para>Domains can be a string array, that can be separated by comma, e.g. 'atwork-it.com', 'delegate365.com'.</maml:para> </maml:description> <command:parameterValue required="true">string[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Settings --> <command:parameter required="false" globbing="false" pipelineInput="false" position="5"> <maml:name>Settings</maml:name> <maml:description> <maml:para>Settings allow to set the notification email, phone number and other settings for the admin.</maml:para> </maml:description> <command:parameterValue required="true">AdministratorSettings</command:parameterValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.AdministratorSettings</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: D365Permission --> <command:parameter required="false" globbing="false" pipelineInput="false" position="6"> <maml:name>D365Permission</maml:name> <maml:description> <maml:para>D365Permission define the name of the permission policy that shall be assigned.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: Administrator --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.Administrator</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>New-DAdministrator -UserPrincipalName 'john.doe@delegate365.com'</dev:code> <dev:remarks> <maml:para>For creating a new admin, a UPN is required.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>$settings = New-Object Delegate365.Api.Core.Models.AdministratorSettings $settings.Email = 'john.doe@delegate365.com' $settings.Phone = '' $settings.UsageLocation = 'US' $settings.DailyNotifications = $false New-DAdministrator -UserPrincipalName john.doe@delegate365.com ` -OrganizationalUnits 'Paris', 'New York' ` -Domains 'atwork-it.com', 'delegate365.com' ` -D365Permission 'Portal Admin'` -Settings $settings</dev:code> <dev:remarks> <maml:para>Additional parameters and settings can be set the new user in one step.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Remove-DAdministrator --> <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"> <command:details> <command:name>Remove-DAdministrator</command:name> <command:verb>Remove</command:verb> <command:noun>DAdministrator</command:noun> <maml:description> <maml:para>Delete an existing administrator from Delegate365. This command is available starting with Delegate365 v8.2</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Delete-DAdministrator removes a specific administrator from the Delegate365. Alias commands are: Delete-DAdmin, Remove-DAdmin. The user object itself stays untouched, just he or she gets removed from them Delegate365 Administrator's list. When deleted, that user no longer has access to the Delegate365 portal. There is no Undo function. In case that user shall get access again, he or she must be created, e.g. with the New-DAdministrator cmdlet. The Delegate365 Audit Logs stay unchanged and Portal Admins can see all logged actions of that user from the past. To remove any user data from the Audit logs, use the GDPR function in Delegate365. The output shows "Successfully deleted", or "Administrator not found" if the user is not existing in the Administrator's list or the error message if another error was thrown.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Remove-DAdministrator</maml:name> <!-- Parameter: Identity --> <command:parameter required="true" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the UserPrincipalName.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: UserPrincipalName --> <command:parameter required="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>UserPrincipalName</maml:name> <maml:description> <maml:para>The UserPrincipalName can be used instead of the Identity parameter.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: Identity --> <command:parameter required="true" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the UserPrincipalName.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: UserPrincipalName --> <command:parameter required="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>UserPrincipalName</maml:name> <maml:description> <maml:para>The UserPrincipalName can be used instead of the Identity parameter.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the UserPrincipalName.</maml:para> </maml:description> </command:inputType> <command:inputType> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <maml:description> <maml:para>The UserPrincipalName can be used instead of the Identity parameter.</maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <!-- OutputType: String --> <command:returnValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Delete-DAdministrator -Identity john.doe@delegate365.com</dev:code> <dev:remarks> <maml:para>Deletes the administrator from the Delegate365 administrator list.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Delete-DAdministrator -UserPrincipalName john.doe@delegate365.com</dev:code> <dev:remarks> <maml:para>Alternatively, the parameter -UserPrincipalName can be used instead of the -Identity parameter.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Set-DAdministrator --> <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"> <command:details> <command:name>Set-DAdministrator</command:name> <command:verb>Set</command:verb> <command:noun>DAdministrator</command:noun> <maml:description> <maml:para>Updates an existing administrator in Delegate365. This command is available starting with Delegate365 v8.2</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Set-DAdministrator modifies an existing administrator in Delegate365. Alias commands are: Set-DAdmin. The administrator that shall be modified must be existing and must be set with the -Identity parameter. This command allows to enable or disable an Administrator, to overwrite his OU and domain settings and to define other admin settings. To remove any existing OU or domain assignments, or the permission policy, use an empty string ''. Otherwise, use a string array to define new OU's or domains, as in the sample below. Optional, additional properties can be handed over to the command, see the example. The output shows the updated admin object.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Set-DAdministrator</maml:name> <!-- Parameter: Identity --> <command:parameter required="true" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the UserPrincipalName.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Active --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Active</maml:name> <maml:description> <maml:para>Active sets the Administrator active or disabled. Disabled Admins cannot access the Delegate365 portal or use PowerShell.</maml:para> </maml:description> <command:parameterValue required="true">bool</command:parameterValue> <dev:type> <maml:name>System.Boolean</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: D365Permission --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>D365Permission</maml:name> <maml:description> <maml:para>D365Permission define the name of the permission policy that shall be assigned. To remove an existing permission, use ''.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Domains --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Domains</maml:name> <maml:description> <maml:para>Domains can be a string array, that can be separated by comma, e.g. 'atwork-it.com', 'delegate365.com'. To remove domains, use ''.</maml:para> </maml:description> <command:parameterValue required="true">string[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OrganizationalUnits --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OrganizationalUnits</maml:name> <maml:description> <maml:para>OrganizationalUnits can be a string array, that can be separated by comma, e.g. 'Paris', 'New York'. To remove OU's, use ''.</maml:para> </maml:description> <command:parameterValue required="true">string[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Settings --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Settings</maml:name> <maml:description> <maml:para>Settings allow to set the notification email, phone number and other settings for the admin.</maml:para> </maml:description> <command:parameterValue required="true">AdministratorSettings</command:parameterValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.AdministratorSettings</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: UserPrincipalName --> <command:parameter required="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>UserPrincipalName</maml:name> <maml:description> <maml:para>The UserPrincipalName can be used instead of the Identity parameter.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: Identity --> <command:parameter required="true" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the UserPrincipalName.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: UserPrincipalName --> <command:parameter required="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>UserPrincipalName</maml:name> <maml:description> <maml:para>The UserPrincipalName can be used instead of the Identity parameter.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OrganizationalUnits --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OrganizationalUnits</maml:name> <maml:description> <maml:para>OrganizationalUnits can be a string array, that can be separated by comma, e.g. 'Paris', 'New York'. To remove OU's, use ''.</maml:para> </maml:description> <command:parameterValue required="true">string[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Domains --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Domains</maml:name> <maml:description> <maml:para>Domains can be a string array, that can be separated by comma, e.g. 'atwork-it.com', 'delegate365.com'. To remove domains, use ''.</maml:para> </maml:description> <command:parameterValue required="true">string[]</command:parameterValue> <dev:type> <maml:name>System.String[]</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Settings --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Settings</maml:name> <maml:description> <maml:para>Settings allow to set the notification email, phone number and other settings for the admin.</maml:para> </maml:description> <command:parameterValue required="true">AdministratorSettings</command:parameterValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.AdministratorSettings</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: D365Permission --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>D365Permission</maml:name> <maml:description> <maml:para>D365Permission define the name of the permission policy that shall be assigned. To remove an existing permission, use ''.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Active --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Active</maml:name> <maml:description> <maml:para>Active sets the Administrator active or disabled. Disabled Admins cannot access the Delegate365 portal or use PowerShell.</maml:para> </maml:description> <command:parameterValue required="true">bool</command:parameterValue> <dev:type> <maml:name>System.Boolean</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the UserPrincipalName.</maml:para> </maml:description> </command:inputType> <command:inputType> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <maml:description> <maml:para>The UserPrincipalName can be used instead of the Identity parameter.</maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <!-- OutputType: Administrator --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.Administrator</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Set-DAdministrator -Identity 'john.doe@delegate365.com' -Active $false</dev:code> <dev:remarks> <maml:para>This disables the administrator from using the Delegate365 portal or using Powershell.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Set-DAdministrator -Identity 'john.doe@delegate365.com' -OrganizationalUnits ''</dev:code> <dev:remarks> <maml:para>Remove all OU assignments from that administrator.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 3 ----------</maml:title> <dev:code>Set-DAdministrator -Identity 'john.doe@delegate365.com' -Domains ''</dev:code> <dev:remarks> <maml:para>Remove all domain assignments from that administrator.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 4 ----------</maml:title> <dev:code>Set-DAdministrator -Identity 'john.doe@delegate365.com' -D365Permission ''</dev:code> <dev:remarks> <maml:para>Remove the existing permission policy from that administrator. That user no longer will see any modules in Delegate365.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 5 ----------</maml:title> <dev:code>Set-DAdministrator -Identity 'john.doe@delegate365.com' -OrganizationalUnits 'Paris', 'New York', 'Kuala Lumpur'</dev:code> <dev:remarks> <maml:para>Overwrite any existing OU assignments with new ones for that administrator.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 6 ----------</maml:title> <dev:code>$settings = New-Object Delegate365.Api.Core.Models.AdministratorSettings $settings.Email = 'john.doe@delegate365.com' $settings.Phone = '' $settings.UsageLocation = 'US' $settings.DailyNotifications = $false Set-DAdministrator -Identity john.doe@delegate365.com ` -Active $true -OrganizationalUnits 'Paris', 'New York' ` -Domains 'atwork-it.com', 'delegate365.com' ` -D365Permission 'Scope Admin'` -Settings $settings</dev:code> <dev:remarks> <maml:para>Overwrite all possible settings of that admin.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Get-DContact --> <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"> <command:details> <command:name>Get-DContact</command:name> <command:verb>Get</command:verb> <command:noun>DContact</command:noun> <maml:description> <maml:para>Gets one or multiple contacts from Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Get-DContact returns a list of contacts from Delegate365. Contacts usually store external person's data in the Office 365 tenant. Parameters allow to get all contacts or one specific contact. Filter for one contact by using the -Identity Parameter and the full name or the ID. The output shows the most essential properties for each contact.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Get-DContact</maml:name> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all contacts (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific contact. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Filter by the name of an OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: UnAssigned --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnAssigned</maml:name> <maml:description> <maml:para>Delivers all contacts that are not assigned to an OU.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: UnAssigned --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnAssigned</maml:name> <maml:description> <maml:para>Delivers all contacts that are not assigned to an OU.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all contacts (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific contact. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Filter by the name of an OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: Contact[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.Contact[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Get-DContact</dev:code> <dev:remarks> <maml:para>By default, the command returns the first 100 assigned contacts.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Get-DContact -All</dev:code> <dev:remarks> <maml:para>Add -All to get all contacts.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 3 ----------</maml:title> <dev:code>Get-DContact -Unassigned -All</dev:code> <dev:remarks> <maml:para>Add -Unassigned to get contacts that are NOT assigned to an OU (can be combined with -All).</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 4 ----------</maml:title> <dev:code>Get-DContact -OU Seattle</dev:code> <dev:remarks> <maml:para>Add -OU to get contacts that are assigned to a specific OU.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 5 ----------</maml:title> <dev:code>Get-DContact -Identity john.doe@outlook.com</dev:code> <dev:remarks> <maml:para>Get one specific contact by name or by ID.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Set-DContact --> <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"> <command:details> <command:name>Set-DContact</command:name> <command:verb>Set</command:verb> <command:noun>DContact</command:noun> <maml:description> <maml:para>Assigns an existing contact to an OU in Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Set-DContact assigns an existing contact to an OU in Delegate365. An existing OU assignment is overwritten. If the contact is unassigned, he gets assigned. As parameters, the Identity (or the WindowsEmailAddress which is the same address) and the OU name must be provided. The output shows the contact object and an operation status. For a successful operation, the Error property is False and the Message property is empty.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Set-DContact</maml:name> <!-- Parameter: Identity --> <command:parameter required="true" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the email address or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Setting the OU name assigns the contact to that OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: WindowsEmailAddress --> <command:parameter required="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>WindowsEmailAddress</maml:name> <maml:description> <maml:para>The WindowsEmailAddress can be used instead of the Identity parameter.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: Identity --> <command:parameter required="true" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the email address or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: WindowsEmailAddress --> <command:parameter required="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>WindowsEmailAddress</maml:name> <maml:description> <maml:para>The WindowsEmailAddress can be used instead of the Identity parameter.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Setting the OU name assigns the contact to that OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the email address or the ID.</maml:para> </maml:description> </command:inputType> <command:inputType> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <maml:description> <maml:para>The WindowsEmailAddress can be used instead of the Identity parameter.</maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <!-- OutputType: SetContactAssign[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.SetContactAssign[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Set-DContact -Identity bobk@tailspintoys.com -OU Chicago</dev:code> <dev:remarks> <maml:para>Assign a contact to an OU. The Identity must be provided by email address or by ID.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Set-DContact -WindowsEmailAddress bobk@tailspintoys.com -OU Chicago</dev:code> <dev:remarks> <maml:para>Alternatively, use the WindowsEmailAddress parameter.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Get-DDistributionGroup --> <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"> <command:details> <command:name>Get-DDistributionGroup</command:name> <command:verb>Get</command:verb> <command:noun>DDistributionGroup</command:noun> <maml:description> <maml:para>Gets one or multiple distribution groups from Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Get-DDistributionGroup returns a list of distribution groups from Delegate365. Distribution groups (DG) allow to deliver emails to multiple users. Parameters allow to get all distribution groups or one specific distribution group. Filter for one distribution group by using the -Identity Parameter and the full name or the ID. The output shows the most essential properties for each distribution group.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Get-DDistributionGroup</maml:name> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all distribution groups (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific distribution group. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Filter by the name of an OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: UnAssigned --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnAssigned</maml:name> <maml:description> <maml:para>Delivers all distribution groups that are not assigned to an OU.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: UnAssigned --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnAssigned</maml:name> <maml:description> <maml:para>Delivers all distribution groups that are not assigned to an OU.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all distribution groups (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific distribution group. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Filter by the name of an OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: DistributionGroup[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.DistributionGroup[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Get-DDistributionGroup</dev:code> <dev:remarks> <maml:para>By default, the command returns the first 100 assigned distribution groups.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Get-DDistributionGroup -All</dev:code> <dev:remarks> <maml:para>Add -All to get all distribution groups.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 3 ----------</maml:title> <dev:code>Get-DDistributionGroup -Unassigned -All</dev:code> <dev:remarks> <maml:para>Add -Unassigned to get distribution groups that are NOT assigned to an OU (can be combined with -All).</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 4 ----------</maml:title> <dev:code>Get-DDistributionGroup -OU Seattle</dev:code> <dev:remarks> <maml:para>Add -OU to get distribution groups that are assigned to a specific OU.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 5 ----------</maml:title> <dev:code>Get-DDistributionGroup -Identity it-department@delegate365.com</dev:code> <dev:remarks> <maml:para>Get one specific distribution group by name or by ID.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Set-DDistributionGroup --> <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"> <command:details> <command:name>Set-DDistributionGroup</command:name> <command:verb>Set</command:verb> <command:noun>DDistributionGroup</command:noun> <maml:description> <maml:para>Assigns an existing distribution group to an OU in Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Set-DDistributionGroup assigns an existing distribution group to an OU in Delegate365. An existing OU assignment is overwritten. If the distribution group is unassigned, it gets assigned. As parameters, the Identity and the OU name must be provided. The output shows the distribution group object and an operation status. For a successful operation, the Error property is False and the Message property is empty.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Set-DDistributionGroup</maml:name> <!-- Parameter: Identity --> <command:parameter required="true" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the email address or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Setting the OU name assigns the distribution group to that OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: PrimarySmtpAddress --> <command:parameter required="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>PrimarySmtpAddress</maml:name> <maml:description> <maml:para>The PrimarySmtpAddress can be used instead of the Identity parameter.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: Identity --> <command:parameter required="true" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the email address or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: PrimarySmtpAddress --> <command:parameter required="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>PrimarySmtpAddress</maml:name> <maml:description> <maml:para>The PrimarySmtpAddress can be used instead of the Identity parameter.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Setting the OU name assigns the distribution group to that OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the email address or the ID.</maml:para> </maml:description> </command:inputType> <command:inputType> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <maml:description> <maml:para>The PrimarySmtpAddress can be used instead of the Identity parameter.</maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <!-- OutputType: SetGroupAssign[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.SetGroupAssign[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Set-DDistributionGroup -Identity hr-department@delegate365.com -OU Chicago</dev:code> <dev:remarks> <maml:para>Assign a distribution group to an OU. The Identity must be provided by email address or by ID.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Set-DDistributionGroup -PrimarySmtpAddress hr-department@delegate365.com -OU Chicago</dev:code> <dev:remarks> <maml:para>Alternatively, use the PrimarySmtpAddress parameter.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Get-DDomain --> <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"> <command:details> <command:name>Get-DDomain</command:name> <command:verb>Get</command:verb> <command:noun>DDomain</command:noun> <maml:description> <maml:para>Gets one or multiple items of the domains in the tenant.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Get-DDomain returns a list of domains from Delegate365. Domains that are added to the Office 365 tenant are updated during each sync in Delegate365. Admins can only see users and groups if they are entitled to use the domain. Parameters allow to get all items or one specific item. The output shows the Id and the name of existing domains.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Get-DDomain</maml:name> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all domains (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific domains. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all domains (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific domains. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: Domain[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.Domain[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Get-DDomain</dev:code> <dev:remarks> <maml:para>By default, the command returns the first 100 assigned items.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Get-DDomain -All</dev:code> <dev:remarks> <maml:para>Add -All to get all items.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 3 ----------</maml:title> <dev:code>Get-DDomain -Identity 'Switzerland'</dev:code> <dev:remarks> <maml:para>Get one specific item by name or by ID.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Get-DDynamicGroup --> <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"> <command:details> <command:name>Get-DDynamicGroup</command:name> <command:verb>Get</command:verb> <command:noun>DDynamicGroup</command:noun> <maml:description> <maml:para>Gets one or multiple dynamic groups from Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Get-DDynamicGroup returns a list of dynamic groups from Delegate365. Dynamic groups allow to specify rules for adding members dynamically based on user properties. Parameters allow to get all dynamic groups or one specific dynamic group. Filter for one dynamic group by using the -Identity Parameter and the full name or the ID. The output shows the most essential properties for each dynamic group.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Get-DDynamicGroup</maml:name> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all dynamic groups (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific dynamic group. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Filter by the name of an OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: UnAssigned --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnAssigned</maml:name> <maml:description> <maml:para>Delivers all dynamic groups that are not assigned to an OU.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: UnAssigned --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnAssigned</maml:name> <maml:description> <maml:para>Delivers all dynamic groups that are not assigned to an OU.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all dynamic groups (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific dynamic group. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Filter by the name of an OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: DynamicGroup[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.DynamicGroup[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Get-DDynamicGroup</dev:code> <dev:remarks> <maml:para>By default, the command returns the first 100 assigned dynamic groups.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Get-DDynamicGroup -All</dev:code> <dev:remarks> <maml:para>Add -All to get all dynamic groups.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 3 ----------</maml:title> <dev:code>Get-DDynamicGroup -Unassigned -All</dev:code> <dev:remarks> <maml:para>Add -Unassigned to get dynamic groups that are NOT assigned to an OU (can be combined with -All).</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 4 ----------</maml:title> <dev:code>Get-DDynamicGroup -OU Seattle</dev:code> <dev:remarks> <maml:para>Add -OU to get dynamic groups that are assigned to a specific OU.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 5 ----------</maml:title> <dev:code>Get-DDynamicGroup -Identity hr-department@delegate365.com</dev:code> <dev:remarks> <maml:para>Get one specific dynamic group by name or by ID.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Set-DDynamicGroup --> <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"> <command:details> <command:name>Set-DDynamicGroup</command:name> <command:verb>Set</command:verb> <command:noun>DDynamicGroup</command:noun> <maml:description> <maml:para>Assigns an existing distribution group to an OU in Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Set-DDynamicGroup assigns an existing distribution group to an OU in Delegate365. An existing OU assignment is overwritten. If the distribution group is unassigned, it gets assigned. As parameters, the Identity and the OU name must be provided. The output shows the distribution group object and an operation status. For a successful operation, the Error property is False and the Message property is empty.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Set-DDynamicGroup</maml:name> <!-- Parameter: Identity --> <command:parameter required="true" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Setting the OU name assigns the distribution group to that OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: PrimarySmtpAddress --> <command:parameter required="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>PrimarySmtpAddress</maml:name> <maml:description> <maml:para>The PrimarySmtpAddress can be used instead of the Identity parameter.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: Identity --> <command:parameter required="true" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: PrimarySmtpAddress --> <command:parameter required="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>PrimarySmtpAddress</maml:name> <maml:description> <maml:para>The PrimarySmtpAddress can be used instead of the Identity parameter.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Setting the OU name assigns the distribution group to that OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> </command:inputType> <command:inputType> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <maml:description> <maml:para>The PrimarySmtpAddress can be used instead of the Identity parameter.</maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <!-- OutputType: SetMailboxAssign[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.SetMailboxAssign[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Set-DDynamicGroup -Identity it-department@delegate365.com -OU Chicago</dev:code> <dev:remarks> <maml:para>Assign a distribution group to an OU. The Identity must be provided by email address or by ID.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Set-DDynamicGroup -PrimarySmtpAddress it-department@delegate365.com -OU Chicago</dev:code> <dev:remarks> <maml:para>Alternatively, use the PrimarySmtpAddress parameter.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Connect-Delegate365 --> <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"> <command:details> <command:name>Connect-Delegate365</command:name> <command:verb>Connect</command:verb> <command:noun>Delegate365</command:noun> <maml:description> <maml:para>Connects to the API in Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Connect-Delegate365 connects to the API in Delegate365. Use this command to connect to your Delegate365 tenant at the beginning of any PowerShell commands or scripts. This command requires a WebApiBaseUrl and a WebApiSasKey parameter. The WebApiBaseUrl is the URI of your Delegate365 tenant, as https://[mycompany].delegate365.com. The WebApiSasKey must be provided by your Delegate365 Portal Admin. It's a key that identifies your admin account and is specific for your use. The key is a string as "123456..". Keep this key well and do not hand it over to other persons, it's your personal access to the API. As output, an informational string is returned. If no error occurs, it should respond with "successfully connected" within some seconds. After a successful connection is established, you can start working with the Delegate365 cmdlets. Afterwards, use Disconnect-Delegate365 to close the connection. Use Get-Command -Module Delegate365 to see a list of available commands in this module, or Get-Help [command] for information about a specific command. Happy automating with Delegate365!</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Connect-Delegate365</maml:name> <!-- Parameter: WebApiSasKey --> <command:parameter required="true" globbing="false" pipelineInput="false" position="0"> <maml:name>WebApiSasKey</maml:name> <maml:description> <maml:para>The API-key can be generated by a Portal Admin in the Delegate365 portal in the administration/administrators menu for each admin. Select a user and click Edit admin. In the user pane, scroll down to the WebApiKey field and generate a new key if needed anytime.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: WebApiBaseUrl --> <command:parameter required="true" globbing="false" pipelineInput="false" position="1"> <maml:name>WebApiBaseUrl</maml:name> <maml:description> <maml:para>The Base-URL is the URL of your Delegate365 portal, e.g. https://mycompany.delegate365.com</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: WebApiSasKey --> <command:parameter required="true" globbing="false" pipelineInput="false" position="0"> <maml:name>WebApiSasKey</maml:name> <maml:description> <maml:para>The API-key can be generated by a Portal Admin in the Delegate365 portal in the administration/administrators menu for each admin. Select a user and click Edit admin. In the user pane, scroll down to the WebApiKey field and generate a new key if needed anytime.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: WebApiBaseUrl --> <command:parameter required="true" globbing="false" pipelineInput="false" position="1"> <maml:name>WebApiBaseUrl</maml:name> <maml:description> <maml:para>The Base-URL is the URL of your Delegate365 portal, e.g. https://mycompany.delegate365.com</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: String --> <command:returnValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>$apiKey = '123456...' $baseUrl = 'https://mycompany.delegate365.com' Connect-Delegate365 -WebApiSasKey $apiKey -WebApiBaseUrl $baseUrl</dev:code> <dev:remarks> <maml:para>Connect to your Delegate365 API with your key and your portal-URL.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Disconnect-Delegate365 --> <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"> <command:details> <command:name>Disconnect-Delegate365</command:name> <command:verb>Disconnect</command:verb> <command:noun>Delegate365</command:noun> <maml:description> <maml:para>Disconnects from the API in Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Disconnect-Delegate365 disconnects your session from the API in Delegate365. Use this command to disconnect from your Delegate365 tenant after being connected. This closes the session. Thanks for using Delegate365!</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Disconnect-Delegate365</maml:name> </command:syntaxItem> </command:syntax> <command:parameters /> <command:inputTypes /> <command:returnValues> <!-- OutputType: String --> <command:returnValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Disconnect-Delegate365</dev:code> <dev:remarks> <maml:para>Disconnect from your Delegate365 API.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: New-DLicenseDefaultQuotas --> <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"> <command:details> <command:name>New-DLicenseDefaultQuotas</command:name> <command:verb>New</command:verb> <command:noun>DLicenseDefaultQuotas</command:noun> <maml:description> <maml:para>Creates license quotas for all OU's and licenses in Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>New-DLicenseDefaultQuotas license quotas for all OU's and licenses in Delegate365. Licenses quotas allow to restrict the number of Office 365 licenses that can be consumed by users per OU. This command does not require any parameters and creates new quotas if not existing for each license and OU with a quota of 0. Existing quotas stay untouched. This helps administrators just to modify a quota and not to create it manually. The output shows the created license quota object.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>New-DLicenseDefaultQuotas</maml:name> </command:syntaxItem> </command:syntax> <command:parameters /> <command:inputTypes /> <command:returnValues> <!-- OutputType: LicenseQuota[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.LicenseQuota[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>New-DLicenseDefaultQuotas</dev:code> <dev:remarks> <maml:para>For filling new license quotas for all OU's and licenses with a quota value of 0. The created quotas and their values should then be modified as needed.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: New-DLicenseQuota --> <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"> <command:details> <command:name>New-DLicenseQuota</command:name> <command:verb>New</command:verb> <command:noun>DLicenseQuota</command:noun> <maml:description> <maml:para>Creates a new license quota in Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>New-DLicenseQuota creates a new license quota in Delegate365. Licenses quotas allow to restrict the number of Office 365 licenses that can be consumed by users per OU. The Quota parameter requires an object representing the desired values to be set, see the example. The output shows the created license quota object.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>New-DLicenseQuota</maml:name> <!-- Parameter: Quota --> <command:parameter required="true" globbing="false" pipelineInput="false" position="0"> <maml:name>Quota</maml:name> <maml:description> <maml:para>Quota is the object representing the desired values to be set.</maml:para> </maml:description> <command:parameterValue required="true">LicenseQuota</command:parameterValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.LicenseQuota</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: Quota --> <command:parameter required="true" globbing="false" pipelineInput="false" position="0"> <maml:name>Quota</maml:name> <maml:description> <maml:para>Quota is the object representing the desired values to be set.</maml:para> </maml:description> <command:parameterValue required="true">LicenseQuota</command:parameterValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.LicenseQuota</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: LicenseQuota[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.LicenseQuota[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>$quota = New-Object Delegate365.Api.Core.Models.LicenseQuota $quota.OrganizationalUnit = 'Seattle' $quota.SkuDisplayName = 'SkuDisplayName' $quota.Quota = 10 $quota.Enforce = $true New-DLicenseQuota -Quota $quota</dev:code> <dev:remarks> <maml:para>For creating a new license quotas, create a new object and assign that to the new quota.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Get-DLicenseQuotas --> <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"> <command:details> <command:name>Get-DLicenseQuotas</command:name> <command:verb>Get</command:verb> <command:noun>DLicenseQuotas</command:noun> <maml:description> <maml:para>Gets one or multiple licenses quotas from Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Get-DLicenseQuotas returns a list of licenses quotas from Delegate365. Licenses quotas allow to restrict the number of Office 365 licenses that can be consumed by users per OU. This command creates a new license quota for an OU.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Get-DLicenseQuotas</maml:name> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all Licenses quota (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific Licenses quota. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Filter by the name of an OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all Licenses quota (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Filter by the name of an OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific Licenses quota. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: LicenseQuota[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.LicenseQuota[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Get-DLicenseQuotas</dev:code> <dev:remarks> <maml:para>By default, the command returns the first 100 assigned licenses quotas.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Get-DLicenseQuotas -All</dev:code> <dev:remarks> <maml:para>Add -All to get all licenses quotas.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 3 ----------</maml:title> <dev:code>Get-DLicenseQuotas -Unassigned -All</dev:code> <dev:remarks> <maml:para>Add -Unassigned to get licenses quotas that are NOT assigned to an OU (can be combined with -All).</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 4 ----------</maml:title> <dev:code>Get-DLicenseQuotas -OU Seattle</dev:code> <dev:remarks> <maml:para>Add -OU to get licenses quotas that are assigned to a specific OU.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 5 ----------</maml:title> <dev:code>Get-DLicenseQuotas -Identity it-department@delegate365.com</dev:code> <dev:remarks> <maml:para>Get one specific licenses quota by name or by ID.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Get-DLicenses --> <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"> <command:details> <command:name>Get-DLicenses</command:name> <command:verb>Get</command:verb> <command:noun>DLicenses</command:noun> <maml:description> <maml:para>Gets one or multiple licenses from Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Get-DLicenses returns a list of licenses from Delegate365. Licenses (SKU's) are a set of license plans that can be assigned to a user to allow access to an Office 365 service. Licenses are syncronized to Delegate365 from the Office 365 tenant and can be renamed within Delegate365 if needed. Parameters allow to get all licenses or one specific license. Filter for one license by using the -Identity Parameter and the full name or the ID. The output shows the existing licenses (SKU) in the Office 365 tenant.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Get-DLicenses</maml:name> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all Licenses (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific Licenses. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all Licenses (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific Licenses. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: License[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.License[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Get-DLicenses</dev:code> <dev:remarks> <maml:para>By default, the command returns the first 100 available licenses in the tenant.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Get-DLicenses -All</dev:code> <dev:remarks> <maml:para>Add -All to get all licenses.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 3 ----------</maml:title> <dev:code>Get-DLicenses -Identity 'Enterprise Mobility + Security E5'</dev:code> <dev:remarks> <maml:para>Get one specific license by name or by ID.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Start-DMfaSync --> <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"> <command:details> <command:name>Start-DMfaSync</command:name> <command:verb>Start</command:verb> <command:noun>DMfaSync</command:noun> <maml:description> <maml:para>Starts the MFA synchronization job in Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Start-DMfaSync starts the Multi Factor Authentication (MFA) synchronization job in Delegate365. This command does not require any parameters. The job runs through the rules defined in the sync rules and sets the desired MFA status to members of the provided security groups. If nor MFA rules are defined, no MFA operations happen. Usually, this job runs automated in the background perodically during the day. The MFA sync duration will vary on the size of the Office 365 tenant and the MFA sync rules defined in Delegate365. As output, an informational string is returned. If no error occurs, it should respond with "Started successfully" within some seconds.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Start-DMfaSync</maml:name> </command:syntaxItem> </command:syntax> <command:parameters /> <command:inputTypes /> <command:returnValues> <!-- OutputType: String --> <command:returnValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Start-DMfaSync</dev:code> <dev:remarks> <maml:para>Start the MFA sync now.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Get-DOffice365Group --> <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"> <command:details> <command:name>Get-DOffice365Group</command:name> <command:verb>Get</command:verb> <command:noun>DOffice365Group</command:noun> <maml:description> <maml:para>Gets one or multiple Office 365 groups from Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Get-DOffice365Group returns a list of Office 365 groups from Delegate365. Office 365 groups (or Unified Groups) live in Azure Active Directory and allow collaboration over mutliple Office 365 services. Parameters allow to get all Office 365 groups or one specific Office 365 group. Filter for one Office 365 group by using the -Identity Parameter and the full name or the ID. The output shows the most essential properties for each Office 365 group.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Get-DOffice365Group</maml:name> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all Office 365 groups (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific Office 365 group. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Filter by the name of an OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: UnAssigned --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnAssigned</maml:name> <maml:description> <maml:para>Delivers all Office 365 groups that are not assigned to an OU.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: UnAssigned --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnAssigned</maml:name> <maml:description> <maml:para>Delivers all Office 365 groups that are not assigned to an OU.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all Office 365 groups (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific Office 365 group. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Filter by the name of an OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: Office365Group[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.Office365Group[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Get-DOffice365Group</dev:code> <dev:remarks> <maml:para>By default, the command returns the first 100 assigned Office 365 groups.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Get-DOffice365Group -All</dev:code> <dev:remarks> <maml:para>Add -All to get all Office 365 groups.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 3 ----------</maml:title> <dev:code>Get-DOffice365Group -Unassigned -All</dev:code> <dev:remarks> <maml:para>Add -Unassigned to get Office 365 groups that are NOT assigned to an OU (can be combined with -All).</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 4 ----------</maml:title> <dev:code>Get-DOffice365Group -OU Seattle</dev:code> <dev:remarks> <maml:para>Add -OU to get Office 365 groups that are assigned to a specific OU.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 5 ----------</maml:title> <dev:code>Get-DOffice365Group -Identity project-tango@delegate365.com</dev:code> <dev:remarks> <maml:para>Get one specific Office 365 group by name or by ID.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Set-DOffice365Group --> <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"> <command:details> <command:name>Set-DOffice365Group</command:name> <command:verb>Set</command:verb> <command:noun>DOffice365Group</command:noun> <maml:description> <maml:para>Assigns an existing Office 365 group to an OU in Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Set-DOffice365Group assigns an existing Office 365 group to an OU in Delegate365. An existing OU assignment is overwritten. If the Office 365 group is unassigned, it gets assigned. As parameters, the Identity and the OU name must be provided. The output shows the Office 365 group object and an operation status. For a successful operation, the Error property is False and the Message property is empty.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Set-DOffice365Group</maml:name> <!-- Parameter: Identity --> <command:parameter required="true" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the email address or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Setting the OU name assigns the Office 365 group to that OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: PrimarySmtpAddress --> <command:parameter required="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>PrimarySmtpAddress</maml:name> <maml:description> <maml:para>The PrimarySmtpAddress can be used instead of the Identity parameter.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: Identity --> <command:parameter required="true" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the email address or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: PrimarySmtpAddress --> <command:parameter required="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>PrimarySmtpAddress</maml:name> <maml:description> <maml:para>The PrimarySmtpAddress can be used instead of the Identity parameter.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Setting the OU name assigns the Office 365 group to that OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the email address or the ID.</maml:para> </maml:description> </command:inputType> <command:inputType> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <maml:description> <maml:para>The PrimarySmtpAddress can be used instead of the Identity parameter.</maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <!-- OutputType: SetGroupAssign[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.SetGroupAssign[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Set-DOffice365Group -Identity project-tango@delegate365.com -OU Chicago</dev:code> <dev:remarks> <maml:para>Assign an Office 365 group to an OU. The Identity must be provided by email address or by ID.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Set-DOffice365Group -PrimarySmtpAddress project-tango@delegate365.com -OU Chicago</dev:code> <dev:remarks> <maml:para>Alternatively, use the PrimarySmtpAddress parameter.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Get-DOrganizationalUnit --> <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"> <command:details> <command:name>Get-DOrganizationalUnit</command:name> <command:verb>Get</command:verb> <command:noun>DOrganizationalUnit</command:noun> <maml:description> <maml:para>Gets one or multiple OUs from Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Get-DOrganizationalUnit returns a list of OUs from Delegate365. Organizational Units (OUs) are used as container to allow delegated management within Delegate365. Parameters allow to get all OUs or one specific OU. Filter for one OU by using the -Identity Parameter and the full name or the ID. The output shows the ID and the name of each OU.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Get-DOrganizationalUnit</maml:name> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all OUs that are not assigned to an OU.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific OU. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all OUs that are not assigned to an OU.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific OU. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: OrganizationalUnit[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.OrganizationalUnit[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Get-DOrganizationalUnit</dev:code> <dev:remarks> <maml:para>By default, the command returns the first 100 assigned OUs.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Get-DOrganizationalUnit -All</dev:code> <dev:remarks> <maml:para>Add -All to get all OUs.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 3 ----------</maml:title> <dev:code>Get-DOrganizationalUnit -Unassigned -All</dev:code> <dev:remarks> <maml:para>Add -Unassigned to get OUs that are NOT assigned to an OU (can be combined with -All).</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 4 ----------</maml:title> <dev:code>Get-DOrganizationalUnit -Identity Seattle</dev:code> <dev:remarks> <maml:para>Get one specific OU by name or by ID.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: New-DOrganizationalUnit --> <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"> <command:details> <command:name>New-DOrganizationalUnit</command:name> <command:verb>New</command:verb> <command:noun>DOrganizationalUnit</command:noun> <maml:description> <maml:para>Creates a new OU in Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>New-DOrganizationalUnit creates a new OU in Delegate365. Organizational Units (OUs) are used as container to allow delegated management within Delegate365. The output shows the created OU object. Once the OU has been created, it can be used for any assignments.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>New-DOrganizationalUnit</maml:name> <!-- Parameter: Name --> <command:parameter required="true" globbing="false" pipelineInput="false" position="0"> <maml:name>Name</maml:name> <maml:description> <maml:para>The name of the new OU is required.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: Name --> <command:parameter required="true" globbing="false" pipelineInput="false" position="0"> <maml:name>Name</maml:name> <maml:description> <maml:para>The name of the new OU is required.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: OrganizationalUnit --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.OrganizationalUnit</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>New-DOrganizationalUnit -Name 'New York'</dev:code> <dev:remarks> <maml:para>For creating a new OU, a name is required.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Get-DPermission --> <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"> <command:details> <command:name>Get-DPermission</command:name> <command:verb>Get</command:verb> <command:noun>DPermission</command:noun> <maml:description> <maml:para>Gets one or multiple permission policies from Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Get-DPermission returns a list of permission policies from Delegate365. Permission policies define what modules and permissions Delegate365 administrators get. Parameters allow to get all permission policies or one specific permission policy. Filter for one permission policy by using the -Identity Parameter and the full name or the ID. The output shows the properties for each permission policy.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Get-DPermission</maml:name> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all permission policies that are not assigned to an OU.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific permission policy. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all permission policies that are not assigned to an OU.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific permission policy. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: D365Policy[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.D365Policy[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Get-DPermission</dev:code> <dev:remarks> <maml:para>By default, the command returns the first 100 assigned permission policies.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Get-DPermission -All</dev:code> <dev:remarks> <maml:para>Add -All to get all permission policies.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 3 ----------</maml:title> <dev:code>Get-DPermission -Identity 'Scope Admins New York'</dev:code> <dev:remarks> <maml:para>Get one specific permission policy by name or by ID.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Get-DResource --> <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"> <command:details> <command:name>Get-DResource</command:name> <command:verb>Get</command:verb> <command:noun>DResource</command:noun> <maml:description> <maml:para>Gets one or multiple resources from Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Get-DResource returns a list of resources from Delegate365. Mailbox of type 'resource' are used to store information about equipment and rooms. Parameters allow to get all resources or one specific resource. Filter for one resource by using the -Identity Parameter and the full name or the ID. The output shows the most essential properties for each resource.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Get-DResource</maml:name> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all resources (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific resource. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Filter by the name of an OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: UnAssigned --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnAssigned</maml:name> <maml:description> <maml:para>Delivers all resources that are not assigned to an OU.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: UnAssigned --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnAssigned</maml:name> <maml:description> <maml:para>Delivers all resources that are not assigned to an OU.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all resources (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific resource. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Filter by the name of an OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: ResourceMailBox[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.ResourceMailBox[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Get-DResource</dev:code> <dev:remarks> <maml:para>By default, the command returns the first 100 assigned resources.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Get-DResource -All</dev:code> <dev:remarks> <maml:para>Add -All to get all resources.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 3 ----------</maml:title> <dev:code>Get-DResource -Unassigned -All</dev:code> <dev:remarks> <maml:para>Add -Unassigned to get resources that are NOT assigned to an OU (can be combined with -All).</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 4 ----------</maml:title> <dev:code>Get-DResource -OU Seattle</dev:code> <dev:remarks> <maml:para>Add -OU to get resources that are assigned to a specific OU.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 5 ----------</maml:title> <dev:code>Get-DResource -Identity ConfRoomCrystal@delegate365.com</dev:code> <dev:remarks> <maml:para>Get one specific resource by name or by ID.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Set-DResource --> <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"> <command:details> <command:name>Set-DResource</command:name> <command:verb>Set</command:verb> <command:noun>DResource</command:noun> <maml:description> <maml:para>Assigns an existing resource to an OU in Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Set-DResource assigns an existing resource to an OU in Delegate365. An existing OU assignment is overwritten. If the resource is unassigned, it gets assigned. As parameters, the Identity and the OU name must be provided. The output shows the resource object and an operation status. For a successful operation, the Error property is False and the Message property is empty.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Set-DResource</maml:name> <!-- Parameter: Identity --> <command:parameter required="true" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the email address or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Setting the OU name assigns the resource to that OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: PrimarySmtpAddress --> <command:parameter required="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>PrimarySmtpAddress</maml:name> <maml:description> <maml:para>The PrimarySmtpAddress can be used instead of the Identity parameter.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: Identity --> <command:parameter required="true" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the email address or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: PrimarySmtpAddress --> <command:parameter required="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>PrimarySmtpAddress</maml:name> <maml:description> <maml:para>The PrimarySmtpAddress can be used instead of the Identity parameter.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Setting the OU name assigns the resource to that OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the email address or the ID.</maml:para> </maml:description> </command:inputType> <command:inputType> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <maml:description> <maml:para>The PrimarySmtpAddress can be used instead of the Identity parameter.</maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <!-- OutputType: SetMailboxAssign[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.SetMailboxAssign[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Set-DResource -Identity ConfRoomCrystal@delegate365.com -OU Chicago</dev:code> <dev:remarks> <maml:para>Assign a resource to an OU. The Identity must be provided by email address or by ID.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Set-DResource -PrimarySmtpAddress ConfRoomCrystal@delegate365.com -OU Chicago</dev:code> <dev:remarks> <maml:para>Alternatively, use the PrimarySmtpAddress parameter.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Get-DSecurityGroup --> <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"> <command:details> <command:name>Get-DSecurityGroup</command:name> <command:verb>Get</command:verb> <command:noun>DSecurityGroup</command:noun> <maml:description> <maml:para>Gets one or multiple security groups from Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Get-DSecurityGroup returns a list of security groups from Delegate365. Security groups (SG) are an essential part in organizing users and can be used to automate OU and license assignments in Delegate365. Parameters allow to get all security groups or one specific security group. Filter for one security group by using the -Identity Parameter and the full name or the ID. The output shows the most essential properties for each security group.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Get-DSecurityGroup</maml:name> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all security groups (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific security group. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Filter by the name of an OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: UnAssigned --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnAssigned</maml:name> <maml:description> <maml:para>Delivers all security groups that are not assigned to an OU.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: UnAssigned --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnAssigned</maml:name> <maml:description> <maml:para>Delivers all security groups that are not assigned to an OU.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all security groups (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific security group. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Filter by the name of an OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: SecurityGroup[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.SecurityGroup[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Get-DSecurityGroup</dev:code> <dev:remarks> <maml:para>By default, the command returns the first 100 assigned security groups.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Get-DSecurityGroup -All</dev:code> <dev:remarks> <maml:para>Add -All to get all security groups.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 3 ----------</maml:title> <dev:code>Get-DSecurityGroup -Unassigned -All</dev:code> <dev:remarks> <maml:para>Add -Unassigned to get security groups that are NOT assigned to an OU (can be combined with -All).</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 4 ----------</maml:title> <dev:code>Get-DSecurityGroup -OU Seattle</dev:code> <dev:remarks> <maml:para>Add -OU to get security groups that are assigned to a specific OU.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 5 ----------</maml:title> <dev:code>Get-DSecurityGroup -Identity 'Sales department'</dev:code> <dev:remarks> <maml:para>Get one specific security group by name or by ID.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Set-DSecurityGroup --> <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"> <command:details> <command:name>Set-DSecurityGroup</command:name> <command:verb>Set</command:verb> <command:noun>DSecurityGroup</command:noun> <maml:description> <maml:para>Assigns an existing security group to an OU in Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Set-DSecurityGroup assigns an existing security group to an OU in Delegate365. An existing OU assignment is overwritten. If the security group is unassigned, it gets assigned. As parameters, the Identity and the OU name must be provided. The output shows the security group object and an operation status. For a successful operation, the Error property is False and the Message property is empty.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Set-DSecurityGroup</maml:name> <!-- Parameter: Identity --> <command:parameter required="true" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the group name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: GroupName --> <command:parameter required="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>GroupName</maml:name> <maml:description> <maml:para>The GroupName can be used instead of the Identity parameter.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Setting the OU name assigns the security group to that OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: Identity --> <command:parameter required="true" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the group name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: GroupName --> <command:parameter required="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>GroupName</maml:name> <maml:description> <maml:para>The GroupName can be used instead of the Identity parameter.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Setting the OU name assigns the security group to that OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the group name or the ID.</maml:para> </maml:description> </command:inputType> <command:inputType> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <maml:description> <maml:para>The GroupName can be used instead of the Identity parameter.</maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <!-- OutputType: SetSecurityGroupAssign[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.SetSecurityGroupAssign[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Set-DSecurityGroup -Identity 'Sales department' -OU Chicago</dev:code> <dev:remarks> <maml:para>Assign a security group to an OU. The Identity must be provided by email address or by ID.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Set-DSecurityGroup -GroupName 'Sales department' -OU Chicago</dev:code> <dev:remarks> <maml:para>Alternatively, use the GroupName parameter.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Get-DSharedMailbox --> <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"> <command:details> <command:name>Get-DSharedMailbox</command:name> <command:verb>Get</command:verb> <command:noun>DSharedMailbox</command:noun> <maml:description> <maml:para>Gets one or multiple shared mailboxes from Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Get-DSharedMailbox returns a list of shared mailboxes from Delegate365. Shared mailboxes can be used as mailbox for mutliple users. Parameters allow to get all shared mailboxes or one specific shared mailbox. Filter for one shared mailbox by using the -Identity Parameter and the full name or the ID. The output shows the most essential properties for each shared mailbox.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Get-DSharedMailbox</maml:name> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all shared mailboxes (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific shared mailboxe. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Filter by the name of an OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: UnAssigned --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnAssigned</maml:name> <maml:description> <maml:para>Delivers all shared mailboxes that are not assigned to an OU.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: UnAssigned --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnAssigned</maml:name> <maml:description> <maml:para>Delivers all shared mailboxes that are not assigned to an OU.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all shared mailboxes (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific shared mailboxe. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Filter by the name of an OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: SharedMailBox[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.SharedMailBox[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Get-DSharedMailbox</dev:code> <dev:remarks> <maml:para>By default, the command returns the first 100 assigned shared mailboxes.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Get-DSharedMailbox -All</dev:code> <dev:remarks> <maml:para>Add -All to get all shared mailboxes.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 3 ----------</maml:title> <dev:code>Get-DSharedMailbox -Unassigned -All</dev:code> <dev:remarks> <maml:para>Add -Unassigned to get shared mailboxes that are NOT assigned to an OU (can be combined with -All).</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 4 ----------</maml:title> <dev:code>Get-DSharedMailbox -OU Seattle</dev:code> <dev:remarks> <maml:para>Add -OU to get shared mailboxes that are assigned to a specific OU.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 5 ----------</maml:title> <dev:code>Get-DSharedMailbox -Identity support@delegate365.com</dev:code> <dev:remarks> <maml:para>Get one specific shared mailbox by name or by ID.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Set-DSharedMailbox --> <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"> <command:details> <command:name>Set-DSharedMailbox</command:name> <command:verb>Set</command:verb> <command:noun>DSharedMailbox</command:noun> <maml:description> <maml:para>Assigns an existing shared mailbox to an OU in Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Set-DSharedMailbox assigns an existing shared mailbox to an OU in Delegate365. An existing OU assignment is overwritten. If the shared mailbox is unassigned, it gets assigned. As parameters, the Identity and the OU name must be provided. The output shows the shared mailbox object and an operation status. For a successful operation, the Error property is False and the Message property is empty.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Set-DSharedMailbox</maml:name> <!-- Parameter: Identity --> <command:parameter required="true" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the email address or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Setting the OU name assigns the distribution group to that OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: PrimarySmtpAddress --> <command:parameter required="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>PrimarySmtpAddress</maml:name> <maml:description> <maml:para>The PrimarySmtpAddress can be used instead of the Identity parameter.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: Identity --> <command:parameter required="true" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the email address or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: PrimarySmtpAddress --> <command:parameter required="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>PrimarySmtpAddress</maml:name> <maml:description> <maml:para>The PrimarySmtpAddress can be used instead of the Identity parameter.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Setting the OU name assigns the distribution group to that OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the email address or the ID.</maml:para> </maml:description> </command:inputType> <command:inputType> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <maml:description> <maml:para>The PrimarySmtpAddress can be used instead of the Identity parameter.</maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <!-- OutputType: SetMailboxAssign[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.SetMailboxAssign[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Set-DSharedMailbox -Identity support@delegate365.com -OU Chicago</dev:code> <dev:remarks> <maml:para>Assign a shared mailbox to an OU. The Identity must be provided by email address or by ID.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Set-DSharedMailbox -PrimarySmtpAddress support@delegate365.com -OU Chicago</dev:code> <dev:remarks> <maml:para>Alternatively, use the PrimarySmtpAddress parameter.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Start-DSync --> <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"> <command:details> <command:name>Start-DSync</command:name> <command:verb>Start</command:verb> <command:noun>DSync</command:noun> <maml:description> <maml:para>Starts the synchronization job in Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Start-DSync starts the synchronization job in Delegate365. This command does not require any parameters. The job checks the delta between the Office 365 tenant and Delegate365 and updates modified objects in Delegate365. Furthermore, the job runs through the rules defined in the sync rules and performs all defined and active operations. If nor custom sync rules are defined, just the update of Delegate365 happens. Usually, this job runs automated in the background perodically during the day. The sync duration will vary on the size of the Office 365 tenant and the sync rules defined in Delegate365. So, a sync can run for some seconds only or for hours. A manual sync makes only sense, if you modified objects outside of Delegate365 in the Office 365 portal or with another tool and you need to surface the changes in Delegate365 immediately. As output, an informational string is returned. If no error occurs, it should respond with "Started successfully" within some seconds.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Start-DSync</maml:name> </command:syntaxItem> </command:syntax> <command:parameters /> <command:inputTypes /> <command:returnValues> <!-- OutputType: String --> <command:returnValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Start-DSync</dev:code> <dev:remarks> <maml:para>Start the sync now.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Get-DUsageLocation --> <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"> <command:details> <command:name>Get-DUsageLocation</command:name> <command:verb>Get</command:verb> <command:noun>DUsageLocation</command:noun> <maml:description> <maml:para>Gets one or multiple items of the usage locations.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Get-DUsageLocation returns a list of usage locations from Delegate365. Usage locations are required to set an Office 365 license to a user and can be managed in Delegate365. Parameters allow to get all items or one specific item. The output shows the Id and the name of existing usage locations.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Get-DUsageLocation</maml:name> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all items (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific item. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all items (and not only the first 100 items).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific item. Wildcards are not supported, use the full name or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: UsageLocation[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.UsageLocation[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Get-DUsageLocation</dev:code> <dev:remarks> <maml:para>By default, the command returns the first 100 assigned items.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Get-DUsageLocation -All</dev:code> <dev:remarks> <maml:para>Add -All to get all items.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 3 ----------</maml:title> <dev:code>Get-DUsageLocation -Identity 'Switzerland'</dev:code> <dev:remarks> <maml:para>Get one specific item by name or by ID.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Get-DUser --> <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"> <command:details> <command:name>Get-DUser</command:name> <command:verb>Get</command:verb> <command:noun>DUser</command:noun> <maml:description> <maml:para>Gets one or multiple users from Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Get-DUser returns a list of users from Delegate365. In Delegate365, users can be managed by Scope Admins if they are assigned to an OU. Parameters allow to get all users, users of a specific OU, or unassigned users. By default, the first 100 users are returned. Use the -All parameter to get the full list of users. Filter for one user by using the -Identity Parameter and the full UserPrincipalName or the ObjectID. The ouput delivers the most essential user properties: the Id in the Delegate365 database, the Identity is the AAD ObjectID, the UserPrincipalName, the DisplayName and the OU assignment.</maml:para> <maml:para>Important: By default, the command shows all users that are assigned to any OU in Delegate365. When using the -Unassigned parameter, all users are returned that are not assigned to an OU. Be aware that this parameter only delivers the unassigned users if the authenticated user is PowerShell Administrator. Scope Admins that are not PowerShell Administrator will see no output (an empty list), while PowerShell Administrators get all the unassigned users.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Get-DUser</maml:name> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all users (and not only the first 100 users).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific user. Wildcards are not supported, use the full UserPrincipalName or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Filter by the name of an OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: UnAssigned --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnAssigned</maml:name> <maml:description> <maml:para>Delivers all users from Delegate365 that are not assigned to an OU. Requires the PowerShell Administration permission.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: UnAssigned --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>UnAssigned</maml:name> <maml:description> <maml:para>Delivers all users from Delegate365 that are not assigned to an OU. Requires the PowerShell Administration permission.</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: All --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>All</maml:name> <maml:description> <maml:para>Delivers all users (and not only the first 100 users).</maml:para> </maml:description> <command:parameterValue required="true">SwitchParameter</command:parameterValue> <dev:type> <maml:name>System.Management.Automation.SwitchParameter</maml:name> <maml:uri /> </dev:type> <dev:defaultValue>False</dev:defaultValue> </command:parameter> <!-- Parameter: Identity --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Filter for one specific user. Wildcards are not supported, use the full UserPrincipalName or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Filter by the name of an OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes /> <command:returnValues> <!-- OutputType: User[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.User[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Get-DUser</dev:code> <dev:remarks> <maml:para>By default, the command returns the first 100 assigned users.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Get-DUser -All</dev:code> <dev:remarks> <maml:para>Add -All to get all users.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 3 ----------</maml:title> <dev:code>Get-DUser -Unassigned -All</dev:code> <dev:remarks> <maml:para>Add -Unassigned to get users that are NOT assigned to an OU (can be combined with -All).</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 4 ----------</maml:title> <dev:code>Get-DUser -OU Seattle</dev:code> <dev:remarks> <maml:para>Add -OU to get users that are assigned to a specific OU.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 5 ----------</maml:title> <dev:code>Get-DUser -Identity john.doe@delegate365.com</dev:code> <dev:remarks> <maml:para>Get one specific user by UPN or by ID.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> <!-- Cmdlet: Set-DUser --> <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"> <command:details> <command:name>Set-DUser</command:name> <command:verb>Set</command:verb> <command:noun>DUser</command:noun> <maml:description> <maml:para>Assigns an existing user to an OU in Delegate365.</maml:para> </maml:description> </command:details> <maml:description> <maml:para>Set-DUser assigns an existing user to an OU in Delegate365. An existing OU assignment is overwritten. If the user is unassigned, he gets assigned. As parameters, the Identity and the OU name must be provided. The output shows the user object and an operation status. For a successful operation, the Error property is False and the Message property is empty.</maml:para> </maml:description> <command:syntax> <!-- Parameter set: __AllParameterSets --> <command:syntaxItem> <maml:name>Set-DUser</maml:name> <!-- Parameter: Identity --> <command:parameter required="true" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the UserPrincipalName or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Setting the OU name assigns the user to that OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: UserPrincipalName --> <command:parameter required="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>UserPrincipalName</maml:name> <maml:description> <maml:para>The UserPrincipalName can be used instead of the Identity parameter.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:syntaxItem> </command:syntax> <command:parameters> <!-- Parameter: Identity --> <command:parameter required="true" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>Identity</maml:name> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the UserPrincipalName or the ID.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: UserPrincipalName --> <command:parameter required="false" globbing="false" pipelineInput="true (ByValue, ByPropertyName)" position="named"> <maml:name>UserPrincipalName</maml:name> <maml:description> <maml:para>The UserPrincipalName can be used instead of the Identity parameter.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> <!-- Parameter: OU --> <command:parameter required="false" globbing="false" pipelineInput="false" position="named"> <maml:name>OU</maml:name> <maml:description> <maml:para>Setting the OU name assigns the user to that OU.</maml:para> </maml:description> <command:parameterValue required="true">string</command:parameterValue> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> </command:parameter> </command:parameters> <command:inputTypes> <command:inputType> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <maml:description> <maml:para>Find a specific item. Wildcards are not supported, use the UserPrincipalName or the ID.</maml:para> </maml:description> </command:inputType> <command:inputType> <dev:type> <maml:name>System.String</maml:name> <maml:uri /> </dev:type> <maml:description> <maml:para>The UserPrincipalName can be used instead of the Identity parameter.</maml:para> </maml:description> </command:inputType> </command:inputTypes> <command:returnValues> <!-- OutputType: SetUserAssign[] --> <command:returnValue> <dev:type> <maml:name>Delegate365.Api.Core.Models.SetUserAssign[]</maml:name> <maml:uri /> </dev:type> </command:returnValue> </command:returnValues> <command:examples> <command:example> <maml:title>---------- EXAMPLE 1 ----------</maml:title> <dev:code>Set-DUser -Identity support@delegate365.com -OU Chicago</dev:code> <dev:remarks> <maml:para>Assign a user to an OU. The Identity must be provided by UserPrincipalName or by ID.</maml:para> </dev:remarks> </command:example> <command:example> <maml:title>---------- EXAMPLE 2 ----------</maml:title> <dev:code>Set-DUser -UserPrincipalName support@delegate365.com -OU Chicago</dev:code> <dev:remarks> <maml:para>Alternatively, use the UserPrincipalName parameter.</maml:para> </dev:remarks> </command:example> </command:examples> <maml:relatedLinks> <maml:navigationLink> <maml:linkText>Delegate365 support</maml:linkText> <maml:uri>https://support.delegate365.com/</maml:uri> </maml:navigationLink> </maml:relatedLinks> </command:command> </helpItems> |