New-SBAuthorizationRule
New-SBAuthorizationRule
Этот командлет создает новое правило авторизации Shared Access Secret (SAS) для пространства имен службы Service Bus.
Синтаксис
Parameter Set: Default
New-SBAuthorizationRule -Name <String> -NamespaceName <String> [-PrimaryKey <String> ] [-Rights <AccessRight[]> ] [-SecondaryKey <String> ] [ <CommonParameters>]
Подробное описание
Запустите New-SBAuthorizationRule, чтобы создать новое правило авторизации Shared Access Secret (SAS), обрабатывающее пространство имен службыСлужебная шина. Правило авторизации SAS позволяет клиентам управлять и обмениваться сообщениями с сущностями обмена сообщениями, определенными в области пространства имен. Правила авторизации SAS используются, когда в качестве клиента невозможно использовать добавленных в домен пользователей. У правила авторизации SAS есть область (пространство имен службыСлужебная шина), набор прав (управление, отправка или получение) и пара ключей (первичный и вторичный), используемые клиентом.
Параметры
-Name<String>
Имя нового правила авторизации.
Псевдонимы |
n |
Обязательное поле? |
true |
Позиция? |
named |
Значение по умолчанию |
нет |
Принимать входные данные конвейера? |
True (ByValue, ByPropertyName) |
Обрабатывать символы-шаблоны? |
false |
-NamespaceName<String>
Область нового правила авторизации.
Псевдонимы |
ns |
Обязательное поле? |
true |
Позиция? |
named |
Значение по умолчанию |
нет |
Принимать входные данные конвейера? |
True (ByValue, ByPropertyName) |
Обрабатывать символы-шаблоны? |
false |
-PrimaryKey<String>
Ключ, который будет использовать это правило авторизации. Если его не указать, Service Bus создаст ключ. Этот параметр можно задать явно, если требуется переустановить ферму, сохранив клиент без изменений.
Псевдонимы |
primary |
Обязательное поле? |
false |
Позиция? |
named |
Значение по умолчанию |
нет |
Принимать входные данные конвейера? |
True (ByPropertyName) |
Обрабатывать символы-шаблоны? |
false |
-Rights<AccessRight[]>
Разделенный запятыми список прав доступа, разрешенных этим правилом авторизации. К правам доступа относятся права на управление, отправку и прослушивание.
Псевдонимы |
rs |
Обязательное поле? |
false |
Позиция? |
named |
Значение по умолчанию |
нет |
Принимать входные данные конвейера? |
True (ByValue, ByPropertyName) |
Обрабатывать символы-шаблоны? |
false |
-SecondaryKey<String>
Ключ, который будет использоваться этим правилом авторизации. Если его не указать, Service Bus создаст ключ. Этот параметр можно задать явно, если требуется переустановить ферму, сохранив клиент без изменений.
Псевдонимы |
secondary |
Обязательное поле? |
false |
Позиция? |
named |
Значение по умолчанию |
нет |
Принимать входные данные конвейера? |
True (ByPropertyName) |
Обрабатывать символы-шаблоны? |
false |
<CommonParameters>
Этот командлет поддерживает общие параметры: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Входы
Входной тип — это тип объектов, которые можно направить в командлет.
Выходные данные
Возвращаемый тип — это тип объектов, возвращаемых командлетом.
Примеры
Пример 1
В приведенном примере для myNamespace создается новое правило myRule. Это новое правило предоставляет права доступа для отправки и прослушивания клиентам, использующим ключ. Обратите внимание, что в этом примере ключ создан автоматически, и требуется вызов Get-SBAuthorizationRule .
PS C:\> New-SBAuthorizationRule -NamespaceName mynamespace -name myRule -Rights send,listen
Пример 2
В приведенном примере для myNamespace создается новое правило myRule2. Для нового правила используется предварительно заданный первичный ключ (32-байтовая строка ASCII).
PS C:\> $myKey = '!@123456789012345678901234567890'PS C:\>$base64Key = [System.Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes($myKey))PS C:\>New-SBAuthorizationRule -NamespaceName myNamespace -name myrule2 -PrimaryKey $base64Key