New-AzureRmADServicePrincipal

Ссылка

Модуль:: AzureRM.Resources

Создает новый субъект-службу Microsoft Entra.

Предупреждение

Модуль AzureRM PowerShell официально объявлен устаревшим с 29 февраля 2024 г. Пользователям рекомендуется выполнить миграцию из AzureRM в модуль Az PowerShell, чтобы обеспечить постоянную поддержку и обновления.

Хотя модуль AzureRM по-прежнему может функционировать, он больше не поддерживается или не поддерживается, размещая любое постоянное использование на усмотрение и риск пользователя. Ознакомьтесь с нашими ресурсами миграции, чтобы получить рекомендации по переходу в модуль Az.

Синтаксис

New-AzureRmADServicePrincipal
   [-ApplicationId <Guid>]
   [-DisplayName <String>]
   [-Password <SecureString>]
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-Scope <String>]
   [-Role <String>]
   [-SkipAssignment]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmADServicePrincipal
   -ApplicationId <Guid>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmADServicePrincipal
   -ApplicationId <Guid>
   -Password <SecureString>
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmADServicePrincipal
   -ApplicationId <Guid>
   -PasswordCredential <PSADPasswordCredential[]>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmADServicePrincipal
   -ApplicationId <Guid>
   -CertValue <String>
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmADServicePrincipal
   -ApplicationId <Guid>
   -KeyCredential <PSADKeyCredential[]>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmADServicePrincipal
   -DisplayName <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmADServicePrincipal
   -DisplayName <String>
   -Password <SecureString>
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmADServicePrincipal
   -DisplayName <String>
   -PasswordCredential <PSADPasswordCredential[]>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmADServicePrincipal
   -DisplayName <String>
   -CertValue <String>
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmADServicePrincipal
   -DisplayName <String>
   -KeyCredential <PSADKeyCredential[]>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmADServicePrincipal
   -ApplicationObject <PSADApplication>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmADServicePrincipal
   -ApplicationObject <PSADApplication>
   -Password <SecureString>
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmADServicePrincipal
   -ApplicationObject <PSADApplication>
   -PasswordCredential <PSADPasswordCredential[]>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmADServicePrincipal
   -ApplicationObject <PSADApplication>
   -CertValue <String>
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzureRmADServicePrincipal
   -ApplicationObject <PSADApplication>
   -KeyCredential <PSADKeyCredential[]>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Описание

Создает новый субъект-службу Microsoft Entra. Набор параметров по умолчанию использует значения по умолчанию для параметров, если пользователь не предоставляет его для них. Дополнительные сведения об используемых значениях по умолчанию см. в описании указанных параметров ниже. Этот командлет имеет возможность назначить роль субъекту-службе с Role параметрами и Scope параметрами. Если ни одному из этих параметров не предоставлено, роль не будет назначена субъекту-службе. Значения по умолчанию для Role Scope параметров — "Участник" и текущая подписка соответственно (примечание. Значения по умолчанию используются только в том случае, если пользователь предоставляет значение для одного из двух параметров, но не другого). Командлет также неявно создает приложение и задает его свойства (если идентификатор ApplicationId не указан). Чтобы обновить определенные параметры приложения, используйте командлет Set-AzureRmADApplication.

Примеры

Пример 1. Простое создание субъекта-службы AD

PS C:\> New-AzureRmADServicePrincipal

Secret                : System.Security.SecureString
ServicePrincipalNames : {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, http://azure-powershell-05-22-2018-18-23-43}
ApplicationId         : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
DisplayName           : azure-powershell-05-22-2018-18-23-43
Id                    : yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy
Type                  : ServicePrincipal

Приведенная выше команда создает субъект-службу AD, используя значения по умолчанию для параметров, которые не указаны. Так как идентификатор приложения не был указан, приложение было создано для субъекта-службы. Так как для Role созданного субъекта-службы нет никаких разрешений.Scope

Пример 2. Создание простого субъекта-службы AD с указанной ролью и областью по умолчанию

PS C:\> New-AzureRmADServicePrincipal -Role Reader

Secret                : System.Security.SecureString
ServicePrincipalNames : {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, http://azure-powershell-05-22-2018-18-23-43}
ApplicationId         : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
DisplayName           : azure-powershell-05-22-2018-18-23-43
Id                    : yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy
Type                  : ServicePrincipal

WARNING: Assigning role 'Reader' over scope '/subscriptions/zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz' to the new service principal.

Приведенная выше команда создает субъект-службу AD, используя значения по умолчанию для параметров, которые не указаны. Так как идентификатор приложения не был указан, приложение было создано для субъекта-службы. Субъект-служба был создан с разрешениями "Читатель" для текущей подписки (так как для параметра не было предоставлено никакого Scope значения).

Пример 3. Создание простого субъекта-службы AD с указанной областью и ролью по умолчанию

PS C:\> New-AzureRmADServicePrincipal -Scope /subscriptions/zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz/resourceGroups/myResourceGroup

Secret                : System.Security.SecureString
ServicePrincipalNames : {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, http://azure-powershell-05-22-2018-18-23-43}
ApplicationId         : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
DisplayName           : azure-powershell-05-22-2018-18-23-43
Id                    : yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy
Type                  : ServicePrincipal

WARNING: Assigning role 'Contributor' over scope '/subscriptions/zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz/resourceGroups/myResourceGroup' to the new service principal.

Приведенная выше команда создает субъект-службу AD, используя значения по умолчанию для параметров, которые не указаны. Так как идентификатор приложения не был указан, приложение было создано для субъекта-службы. Субъект-служба был создан с разрешениями "Участник" (так как для параметра не было указано значение) в Role заданной области группы ресурсов.

Пример 4. Создание простого субъекта-службы AD с указанной областью и ролью

PS C:\> New-AzureRmADServicePrincipal -Role Reader -Scope /subscriptions/zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz/resourceGroups/myResourceGroup

Secret                : System.Security.SecureString
ServicePrincipalNames : {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, http://azure-powershell-05-22-2018-18-23-43}
ApplicationId         : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
DisplayName           : azure-powershell-05-22-2018-18-23-43
Id                    : yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy
Type                  : ServicePrincipal

WARNING: Assigning role 'Reader' over scope '/subscriptions/zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz/resourceGroups/myResourceGroup' to the new service principal.

Приведенная выше команда создает субъект-службу AD, используя значения по умолчанию для параметров, которые не указаны. Так как идентификатор приложения не был указан, приложение было создано для субъекта-службы. Субъект-служба был создан с разрешениями читателя по заданной области группы ресурсов.

Пример 5. Создание субъекта-службы AD с помощью идентификатора приложения с назначением ролей

PS C:\> New-AzureRmADServicePrincipal -ApplicationId 00001111-aaaa-2222-bbbb-3333cccc4444

ServicePrincipalNames : {00001111-aaaa-2222-bbbb-3333cccc4444, http://my-temp-app}
ApplicationId         : 00001111-aaaa-2222-bbbb-3333cccc4444
DisplayName           : my-temp-app
Id                    : yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy
Type                  : ServicePrincipal

Создает новый субъект-службу AD для приложения с идентификатором приложения "00001111-aaaa-2222-bbbb-3333cccc4444". Так как для Role созданного субъекта-службы нет никаких разрешений.Scope

Пример 6. Создание нового субъекта-службы AD с помощью piping

PS C:\> Get-AzureRmADApplication -ObjectId 3ede3c26-b443-4e0b-9efc-b05e68338dc3 | New-AzureRmADServicePrincipal

Возвращает приложение с идентификатором объекта "3ede3c26-b443-4e0b-9efc-b05e68338dc3" и каналами, которые передается командлету New-AzureRmADServicePrincipal, чтобы создать новый субъект-службу AD для этого приложения.

Параметры

-ApplicationId

Уникальный идентификатор приложения для субъекта-службы в клиенте. После создания этого свойства нельзя изменить. Если идентификатор приложения не указан, он будет создан.

Тип:	Guid
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-ApplicationObject

Объект, представляющий приложение, для которого создается субъект-служба.

Тип:	PSADApplication
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-CertValue

Значение типа асимметричных учетных данных. Он представляет базовый 64 кодированный сертификат.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Confirm

Запрос подтверждения перед выполнением командлета.

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DefaultProfile

Учетные данные, учетная запись, клиент и подписка, используемые для обмена данными с Azure

Тип:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-DisplayName

Понятное имя субъекта-службы. Если отображаемое имя не указано, это значение по умолчанию имеет значение azure-powershell-MM-d-yd-yy-HH-mm-ss, где суффикс — это время создания приложения.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-EndDate

Дата окончания использования учетных данных. Значение даты окончания по умолчанию — один год с сегодняшнего дня. Для учетных данных типа асимметричного типа необходимо задать значение до даты, в которую действителен сертификат X509.

Тип:	DateTime
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-KeyCredential

Коллекция ключевых учетных данных, связанных с приложением.

Тип:	PSADKeyCredential[]
Aliases:	KeyCredentials
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Password

Пароль, связанный с субъектом-службой. Если пароль не указан, будет создан случайный GUID и использоваться в качестве пароля.

Тип:	SecureString
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-PasswordCredential

Коллекция учетных данных паролей, связанных с приложением.

Тип:	PSADPasswordCredential[]
Aliases:	PasswordCredentials
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False

-Role

Роль, которую субъект-служба имеет над областью. Если задано значение Scope , но для этого значения не указано Role, по Role умолчанию будет использоваться роль "Участник".

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-Scope

Область, в которую субъект-служба имеет разрешения. Если задано значение Role , но для нее не указано Scope, то Scope по умолчанию используется текущая подписка.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-SkipAssignment

Если задано, пропустите создание назначения ролей по умолчанию для субъекта-службы.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-StartDate

Дата начала использования учетных данных. Значение даты начала по умолчанию сегодня. Для учетных данных типа asymmetric это должно быть задано в или после даты, из которую сертификат X509 действителен.

Тип:	DateTime
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False

Входные данные

Guid

String

PSADApplication

Параметры: ApplicationObject (ByValue)

PSADPasswordCredential[]

PSADKeyCredential[]

SecureString

DateTime

Выходные данные

PSADServicePrincipal

Microsoft.Azure.Commands.Resources.Models.Authorization.PSADServicePrincipalWrapper

Примечания

Ключевые слова: azure, azurerm, arm, resource, management, manager, resource, group, template, deployment

Поделиться через

New-AzureRmADServicePrincipal

Синтаксис

Описание

Примеры

Пример 1. Простое создание субъекта-службы AD

Пример 2. Создание простого субъекта-службы AD с указанной ролью и областью по умолчанию

Пример 3. Создание простого субъекта-службы AD с указанной областью и ролью по умолчанию

Пример 4. Создание простого субъекта-службы AD с указанной областью и ролью

Пример 5. Создание субъекта-службы AD с помощью идентификатора приложения с назначением ролей

Пример 6. Создание нового субъекта-службы AD с помощью piping

Параметры

-ApplicationId

-ApplicationObject

-CertValue

-Confirm

-DefaultProfile

-DisplayName

-EndDate

-KeyCredential

-Password

-PasswordCredential

-Role

-Scope

-SkipAssignment

-StartDate

-WhatIf

Входные данные

Выходные данные

Примечания

Дополнительные ресурсы

Поделиться через

New-AzureRmADServicePrincipal

Синтаксис

Описание

Примеры

Пример 1. Простое создание субъекта-службы AD

Пример 2. Создание простого субъекта-службы AD с указанной ролью и областью по умолчанию

Пример 3. Создание простого субъекта-службы AD с указанной областью и ролью по умолчанию

Пример 4. Создание простого субъекта-службы AD с указанной областью и ролью

Пример 5. Создание субъекта-службы AD с помощью идентификатора приложения с назначением ролей

Пример 6. Создание нового субъекта-службы AD с помощью piping

Параметры

-ApplicationId

-ApplicationObject

-CertValue

-Confirm

-DefaultProfile

-DisplayName

-EndDate

-KeyCredential

-Password

-PasswordCredential

-Role

-Scope

-SkipAssignment

-StartDate

-WhatIf

Входные данные

Выходные данные

Примечания

Связанные ссылки

Дополнительные ресурсы